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 Shared Function GenerateColumns (
	itemProperties As IItemProperties
) As Collection(Of DataGridColumn)


Type: System.ComponentModel.IItemProperties

The properties of the object to be in the columns.

Return Value

Type: System.Collections.ObjectModel.Collection(Of 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