Skip to main content

GridViewSettings.CustomUnboundColumnData Property

Enables data to be supplied to unbound columns.

Namespace: DevExpress.Web.Mvc

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

Declaration

public ASPxGridViewColumnDataEventHandler CustomUnboundColumnData { get; set; }

Property Value

Type Description
ASPxGridViewColumnDataEventHandler

A ASPxGridViewColumnDataEventHandler delegate method allowing you to implement custom processing.

Remarks

To provide unbound columns with data using a delegate method, assign this delegate method to the CustomUnboundColumnData property. The delegate method assigned to this property will be called for unbound columns only.

The code sample below demonstrates how to add an unbound column that retrieves data using a delegate method.

Partial View code:

@Html.DevExpress().GridView(settings => {
    settings.Name = "GridView";
    settings.CallbackRouteValues = new { Controller = "Home", Action = "GridViewPartial" };
    // ...
    // Add columns bound to model fields.
    settings.Columns.Add("FirstName");
    settings.Columns.Add("LastName");
    settings.Columns.Add(column => {
        // "FieldName" contains a unique value that does not refer to any field in the GridView's data model. 
        column.FieldName = "FullName";
        // The column contains string values.
        column.UnboundType = DevExpress.Data.UnboundColumnType.String;
    });
    // A delegate method that allows you to generate data for an unbound column.
    settings.CustomUnboundColumnData = (s, e) => {
        if (e.Column.FieldName == "FullName") {
            string firstName = (e.GetListSourceFieldValue("FirstName")).ToString();
            string lastName = (e.GetListSourceFieldValue("LastName")).ToString();
            e.Value = firstName + " " + lastName;
        };
    };
}).Bind(Model).GetHtml()

Note

When the GridView extension is bound to a data source in Database Server Mode, you can only enable sorting, grouping, filtering and summary calculation for unbound columns that are populated with unbound expressions.

See Also