ListBoxExtension.BindToEF(String, String, EventHandler<LinqServerModeDataSourceSelectEventArgs>, EventHandler<ServerModeExceptionThrownEventArgs>) Method

Binds the list box to a data source using the Entity Framework in database server mode.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v20.2.dll

Declaration

public ListBoxExtension BindToEF(
    string contextTypeName,
    string tableName,
    EventHandler<LinqServerModeDataSourceSelectEventArgs> selectingMethod,
    EventHandler<ServerModeExceptionThrownEventArgs> exceptionThrownMethod
)
Public Function BindToEF(
    contextTypeName As String,
    tableName As String,
    selectingMethod As EventHandler(Of LinqServerModeDataSourceSelectEventArgs),
    exceptionThrownMethod As EventHandler(Of ServerModeExceptionThrownEventArgs)
) As ListBoxExtension

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 catching unhandled/CLR exceptions that appear.

Returns

Type Description
ListBoxExtension

A ListBoxExtension object representing the list box extension.

Remarks

Use the BindToEF method to bind the list box to Entity Framework data models.

Internally, the BindToEF method uses our EntityServerModeDataSource component, which was specifically designed to allow the list 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 list box. In this mode, the list box loads records on demand and performs data-aware operations on the data server. This technique significantly improves the list 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.

See Also