Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DataGrid.GenerateColumns Method (IItemProperties)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Generates columns for the specified properties of an object.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public static Collection<DataGridColumn> GenerateColumns(
	IItemProperties itemProperties


Type: System.ComponentModel.IItemProperties

The properties of the object to be in the columns.

Return Value

Type: System.Collections.ObjectModel.Collection<DataGridColumn>

The collection of columns for the properties of the object.

Exception Condition

itemProperties is null.

Each row in the data grid is bound to an object in the data source, and each column in the data grid is bound to a property of the data object. This method generates a collection that contains a column for each property.

Calling the GenerateColumns method provides the same functionality as setting the AutoGenerateColumns property to true. You will typically not call this method from your code.

This method is provided to enable designer tools to generate a collection of columns that can be edited by the user and then placed into the data grid. A designer tool can use the GenerateColumns method to return a collection of auto-generated columns. The designer tool can then provide a user interface to enable the user to edit the column types, and add or remove columns as necessary. The column collection can then be used to populate the Columns collection of the data grid by adding each column to the collection.

.NET Framework
Available since 4.0
Return to top
© 2018 Microsoft