ColumnViewOptionsBehavior.AutoPopulateColumns Property

Gets or sets whether columns should be created automatically for all fields in the underlying data source when the View doesn’t contain any columns. When bound to a business object, the grid does not generate columns for properties of collection types.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool AutoPopulateColumns { get; set; }

VB.NET

<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property AutoPopulateColumns As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true, if the columns are created automatically when the View doesn’t contain any columns; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AutoPopulateColumns
AdvBandedGridView	.OptionsBehavior.AutoPopulateColumns
BandedGridView	.OptionsBehavior.AutoPopulateColumns
ColumnView	.OptionsBehavior.AutoPopulateColumns
CardView	.OptionsBehavior.AutoPopulateColumns
GridView	.OptionsBehavior.AutoPopulateColumns
LayoutView	.OptionsBehavior.AutoPopulateColumns
TileView	.OptionsBehavior.AutoPopulateColumns
WinExplorerView	.OptionsBehavior.AutoPopulateColumns

Remarks

This property determines whether the BaseView.PopulateColumns method is called automatically when a data source is assigned to a View which doesn’t contain any columns. The BaseView.PopulateColumns method creates GridColumn objects for all the fields in the underlying data source and make these columns visible.

Set the AutoPopulateColumns property to false to prevent columns from being automatically created.

Note

A business object bound to a Grid Control may contain properties of collection types (e.g., of the List<> type). These properties instruct the Grid to enable master-detail mode (see Working with Master-Detail Relationships in Code). Columns corresponding to collection properties are not created in a master View.

Related GitHub Examples

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

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#

Reporting_how-to-create-a-label-report-at-runtime-t473792/CS/dxWinFormsSample/Form1.cs#L57

lookUpLabelProduct.Properties.DataSource = helper.GetLabelProducts().ToList();
lookUpLabelProduct.Properties.View.OptionsBehavior.AutoPopulateColumns = false;
lookUpLabelProduct.Properties.View.OptionsView.ShowColumnHeaders = false;

objectdatasource-how-to-provide-a-custom-parameter-editor-t246429/CS/CustomRepositoryItem/MyRepositoryItemsProvider.cs#L35

lookUpEdit = new RepositoryItemGridLookUpEdit();
lookUpEdit.View.OptionsBehavior.AutoPopulateColumns = false;
lookUpEdit.DataSource = History.GetAll().Select(deal => new Record(deal.Customer)).ToList();

XDL_how-to-utilize-the-unboundsource-component-in-code-t474976/CS/UnboundDS-Code/Form1.cs#L11

InitializeComponent();
gridView1.OptionsBehavior.AutoPopulateColumns = false;
CreateDS();

VB.NET

Reporting_how-to-create-a-label-report-at-runtime-t473792/VB/dxWinFormsSample/Form1.vb#L49

lookUpLabelProduct.Properties.DataSource = helper.GetLabelProducts().ToList()
lookUpLabelProduct.Properties.View.OptionsBehavior.AutoPopulateColumns = False
lookUpLabelProduct.Properties.View.OptionsView.ShowColumnHeaders = False

objectdatasource-how-to-provide-a-custom-parameter-editor-t246429/VB/CustomRepositoryItem/MyRepositoryItemsProvider.vb#L50

lookUpEdit = New RepositoryItemGridLookUpEdit()
lookUpEdit.View.OptionsBehavior.AutoPopulateColumns = False
lookUpEdit.DataSource = History.GetAll().Select(Function(deal) New Record(deal.Customer)).ToList()

XDL_how-to-utilize-the-unboundsource-component-in-code-t474976/VB/UnboundDS-Code/Form1.vb#L13

InitializeComponent()
gridView1.OptionsBehavior.AutoPopulateColumns = False
CreateDS()