GridControl.ForceInitialize() Method

Forces the grid control to finish its initialization. Call this method when the form is loading, before you start to change the grid’s options.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

public virtual void ForceInitialize()

VB.NET

Public Overridable Sub ForceInitialize

Remarks

After the grid control has been initialized, you can manipulate its settings safely. Call the ForceInitialize method before you:

• group and/or sort data;
• change summary settings;
• expand and collapse rows;
• create columns and change their visibility;
• restore a layout, etc.

Note

The ForceInitialize method has no effect until the form’s Load event occurs. For instance, nothing will happen if you add this method in the form’s constructor.

The code sample below illustrates how to safely add a column to a grid.

C#

using DevExpress.XtraGrid;
using DevExpress.XtraGrid.Views.Grid;

private void XtraForm1_Load(object sender, EventArgs e)
{
    gridControl1.ForceInitialize();
    gridView1.Columns.Add();
    gridView1.Columns[gridView1.Columns.Count - 1].Caption = "Actions";
    gridView1.Columns[gridView1.Columns.Count - 1].VisibleIndex = gridView1.Columns.Count;
}

VB.NET

Imports DevExpress.XtraGrid
Imports DevExpress.XtraGrid.Views.Grid

Private Sub XtraForm1_Load(ByVal sender As Object, ByVal e As EventArgs)
    gridControl1.ForceInitialize()
    gridView1.Columns.Add()
    gridView1.Columns(gridView1.Columns.Count - 1).Caption = "Actions"
    gridView1.Columns(gridView1.Columns.Count - 1).VisibleIndex = gridView1.Columns.Count
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ForceInitialize() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-provide-the-capability-to-create-fixed-rows-in-the-gridview-e3045/CS/SplitDescendantWithExtension/FixedRowsExtension.cs#L37

gridControl1 = gridSplitContainer1.Grid as GridControl;
gridControl1.ForceInitialize();
gridViewPanel1 = gridControl1.MainView as GridView;

how-to-use-the-layoutview-cardview-as-a-master-view-in-master-detail-mode-e2428/CS/WindowsApplication3/Form1.cs#L27

gridControl1.ForceInitialize();
helper = new MasterDetailHelper(layoutView1, ViewType.Grid);

how-to-use-typeconverter-for-converting-values-displayed-in-a-gridlookupedit-dropdown-e2814/CS/E2814/WindowsApplication3/Main.cs#L62

gridControl1.DataSource = gridList;
gridControl1.ForceInitialize();
gridView1.Columns["ID"].ColumnEdit = edit;

custom-gridcontrol-how-to-create-columns-with-the-editorshowmode-property-e4356/CS/GridProject/Form1.cs#L26

extendedGridControl1.ForceInitialize();

how-to-implement-a-flashing-cell-in-gridview-e2987/CS/Form1.cs#L41

gridControl1.DataSource = CreateTable(5);
gridControl1.ForceInitialize();
gridView1.Columns[0].Width = 20;

VB.NET

how-to-use-the-layoutview-cardview-as-a-master-view-in-master-detail-mode-e2428/VB/WindowsApplication3/Form1.vb#L28

gridControl1.ForceInitialize()
helper = New MasterDetailHelper(layoutView1, ViewType.Grid)

how-to-use-typeconverter-for-converting-values-displayed-in-a-gridlookupedit-dropdown-e2814/VB/WindowsApplication3/Main.vb#L65

gridControl1.DataSource = gridList
gridControl1.ForceInitialize()
gridView1.Columns("ID").ColumnEdit = edit

custom-gridcontrol-how-to-create-columns-with-the-editorshowmode-property-e4356/VB/GridProject/Form1.vb#L24

extendedGridControl1.ForceInitialize()

how-to-implement-a-flashing-cell-in-gridview-e2987/VB/Form1.vb#L40

gridControl1.DataSource = CreateTable(5)
gridControl1.ForceInitialize()
gridView1.Columns(0).Width = 20

XPO_how-to-create-an-xpclassinfo-descendant-to-dynamically-build-a-persistent-class-structure-e1729/VB/Form1.vb#L50

    'grdTableBrowser.ServerMode = true;
    grdTableBrowser.ForceInitialize()
Catch ex As Exception