TokenBoxExtension.BindToEF(String, String, EventHandler<LinqServerModeDataSourceSelectEventArgs>, EventHandler<ServerModeExceptionThrownEventArgs>) Method
Binds the token box to a data source using the Entity Framework in database server mode.
Namespace: DevExpress.Web.Mvc
Assembly: DevExpress.Web.Mvc5.v24.1.dll
NuGet Package: DevExpress.Web.Mvc5
Declaration
public TokenBoxExtension BindToEF(
string contextTypeName,
string tableName,
EventHandler<LinqServerModeDataSourceSelectEventArgs> selectingMethod,
EventHandler<ServerModeExceptionThrownEventArgs> exceptionThrownMethod
)
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
Use the BindToEF method to bind the token box to Entity Framework data models.
Internally, the BindToEF method uses our EntityServerModeDataSource component, which was specifically designed to allow the token box to efficiently process large amounts of data. The EntityServerModeDataSource component automatically enables database server mode to optimize the execution of all queries to the data context 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 BindToEF overload catches and conceals any exception thrown by an EF data provider. To catch these exceptions manually, use the BindToEF(string contextTypeName, string tableName, EventHandler<LinqServerModeDataSourceSelectEventArgs> selectingMethod, EventHandler<ServerModeExceptionThrownEventArgs> exceptionThrownMethod) overload method.