GridViewExtension.BindToEF(String, String) Method

Binds the GridView to a data source via the Entity Framework in database server mode.

Namespace: DevExpress.Web.Mvc

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

NuGet Package: DevExpress.Web.Mvc5

Declaration

C#

public GridViewExtension BindToEF(
    string contextTypeName,
    string tableName
)

VB.NET

Public Function BindToEF(
    contextTypeName As String,
    tableName As String
) As GridViewExtension

Parameters

Name	Type	Description
contextTypeName	String	A String object representing the DataContext type name.
tableName	String	A String object specifying the table name.

Returns

Type	Description
GridViewExtension	A GridViewExtension object representing the GridView extension.

Remarks

Using the BindToEF method, you can easily bind the GridView to Entity Framework data models. Simply call the method, pass the DataContext and table name as method parameters, and specify the key field via the GridView’s GridSettingsBase.KeyFieldName property.

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