TokenBoxExtension.BindToLINQ(String, String, EventHandler<LinqServerModeDataSourceSelectEventArgs>, EventHandler<ServerModeExceptionThrownEventArgs>) Method

Binds the token box to a queryable source in database server mode.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v24.1.dll

NuGet Package: DevExpress.Web.Mvc5

Declaration

C#

public TokenBoxExtension BindToLINQ(
    string contextTypeName,
    string tableName,
    EventHandler<LinqServerModeDataSourceSelectEventArgs> selectingMethod,
    EventHandler<ServerModeExceptionThrownEventArgs> exceptionThrownMethod
)

VB.NET

Public Function BindToLINQ(
    contextTypeName As String,
    tableName As String,
    selectingMethod As EventHandler(Of LinqServerModeDataSourceSelectEventArgs),
    exceptionThrownMethod As EventHandler(Of ServerModeExceptionThrownEventArgs)
) As TokenBoxExtension

Parameters

Name	Type	Description
contextTypeName	String	A String object representing the DataContext type name.
tableName	String	A String object specifying the table name.
selectingMethod	EventHandler<LinqServerModeDataSourceSelectEventArgs>	A method to which selection logic is delegated.
exceptionThrownMethod	EventHandler<ServerModeExceptionThrownEventArgs>	A delegate method that allows you to catch unhandled/CLR exceptions.

Returns

Type	Description
TokenBoxExtension	A TokenBoxExtension object representing the token box extension.

Remarks

Using the BindToLINQ method, you can easily bind the token box to queryable data sources.

Internally, the BindToLINQ method uses our LinqServerModeDataSource component, which was specifically designed to allow the token box to efficiently process large amounts of data. The LinqServerModeDataSource component automatically enables database server mode to optimize the execution of all LINQ queries initiated by the token box. In this mode, the token box loads records on demand and performs data-aware operations on the data server. This technique significantly improves the token box’s speed and responsiveness.

Note

The current BindToLINQ overload catches and conceals any exception thrown by an IQueryable provider. To catch these exceptions manually, use the BindToLINQ(string contextTypeName, string tableName, EventHandler<LinqServerModeDataSourceSelectEventArgs> selectingMethod, EventHandler<ServerModeExceptionThrownEventArgs> exceptionThrownMethod) overload method.