GridControl.ForceInitialize() Method

Forces the grid control to finish its initialization.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v17.2.dll

Declaration

C#

public virtual void ForceInitialize()

VB.NET

Public Overridable Sub ForceInitialize

Remarks

You must call the ForceInitialize method before changing grid options when a form is being loaded (for instance, when changing grid’s settings in the Form.Load event handler). After the grid control has been initialized, you can manipulate its settings safely. For instance, you should call the ForceInitialize method before:

• applying data grouping and/or sorting;
• changing summary settings;
• expanding and collapsing rows;
• creating columns and changing their visible state;
• restoring a layout, etc.

Note

Calling the ForceInitialize method before the form’ Load event occurs is not in effect. For instance, calling this method in the form’s constructor is not in effect.

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-display-a-readonly-html-formatted-text-in-grid-cells-e3167/CS/WindowsApplication3/Main.cs#L38

gridControl1.RepositoryItems.Add(edit);
gridControl1.ForceInitialize();

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();

VB.NET

how-to-display-a-readonly-html-formatted-text-in-grid-cells-e3167/VB/WindowsApplication3/Main.vb#L37

gridControl1.RepositoryItems.Add(edit)
gridControl1.ForceInitialize()

how-to-provide-the-capability-to-create-fixed-rows-in-the-gridview-e3045/VB/SplitDescendantWithExtension/FixedRowsExtension.vb#L35

gridControl1 = TryCast(gridSplitContainer1.Grid, GridControl)
gridControl1.ForceInitialize()
gridViewPanel1 = TryCast(gridControl1.MainView, GridView)

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()