ASPxGridListEditor.CustomizeGridViewDataColumn Event

Occurs after the data column is created, before it is added to the grid control.

Namespace: DevExpress.ExpressApp.Web.Editors.ASPx

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

NuGet Package: DevExpress.ExpressApp.Web

Declaration

C#

public event EventHandler<CustomizeGridViewDataColumnEventArgs> CustomizeGridViewDataColumn

VB.NET

Public Event CustomizeGridViewDataColumn As EventHandler(Of CustomizeGridViewDataColumnEventArgs)

Event Data

The CustomizeGridViewDataColumn event's data class is CustomizeGridViewDataColumnEventArgs. The following properties provide information specific to this event:

Property	Description
Column	Gets the data column.
ModelColumn	Gets the Application Model settings of the column.

Remarks

Handle this event to customize the column after the Application Model settings are applied to it and the ITemplate templates are assigned to the GridViewDataColumn.DataItemTemplate and GridViewDataColumn.EditItemTemplate properties.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Web.Editors.ASPx;
// ...
public class CustomizeGridViewDataColumnController : ObjectViewController<ListView, Person> {
    protected override void OnActivated() {
        base.OnActivated();
        ASPxGridListEditor listEditor = (ASPxGridListEditor)View.Editor;
        listEditor.CustomizeGridViewDataColumn += listEditor_CustomizeGridViewDataColumn;
    }
    private void listEditor_CustomizeGridViewDataColumn(object sender, CustomizeGridViewDataColumnEventArgs e) {
        if (e.ModelColumn.Id == "FirstName") {
            e.Column.Caption = "Custom FirstName Caption";
        }
    }
    protected override void OnDeactivated() {
        base.OnDeactivated();
        ASPxGridListEditor listEditor = (ASPxGridListEditor)View.Editor;
        listEditor.CustomizeGridViewDataColumn -= listEditor_CustomizeGridViewDataColumn;
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Web.Editors.ASPx
' ...
Public Class CustomizeGridViewDataColumnController 
    Inherits ObjectViewController(Of ListView, Person)
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        Dim listEditor As ASPxGridListEditor = CType(View.Editor, ASPxGridListEditor)
        AddHandler listEditor.CustomizeGridViewDataColumn, AddressOf listEditor_CustomizeGridViewDataColumn
    End Sub
    Private Sub listEditor_CustomizeGridViewDataColumn(ByVal sender As Object, ByVal e As CustomizeGridViewDataColumnEventArgs)
        If e.ModelColumn.Id = "FirstName" Then
            e.Column.Caption = "Custom FirstName Caption"
        End If
    End Sub
    Protected Overrides Sub OnDeactivated()
        MyBase.OnDeactivated()
        Dim listEditor As ASPxGridListEditor = CType(View.Editor, ASPxGridListEditor)
        RemoveHandler listEditor.CustomizeGridViewDataColumn, AddressOf listEditor_CustomizeGridViewDataColumn
    End Sub
End Class

Important

You should subscribe to this event before the View.ControlsCreated event occurs (e.g., in the overridden OnActivated method of a custom Controller). It is too late to customize columns when the grid control has already been created.