DataGrid.GenerateColumns(IItemProperties) Method

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Generates columns for the specified properties of an object.

public:
 static System::Collections::ObjectModel::Collection<System::Windows::Controls::DataGridColumn ^> ^ GenerateColumns(System::ComponentModel::IItemProperties ^ itemProperties);

public static System.Collections.ObjectModel.Collection<System.Windows.Controls.DataGridColumn> GenerateColumns (System.ComponentModel.IItemProperties itemProperties);

static member GenerateColumns : System.ComponentModel.IItemProperties -> System.Collections.ObjectModel.Collection<System.Windows.Controls.DataGridColumn>

Public Shared Function GenerateColumns (itemProperties As IItemProperties) As Collection(Of DataGridColumn)

Parameters

itemProperties

IItemProperties

The properties of the object to be in the columns.

Returns

Collection<DataGridColumn>

The collection of columns for the properties of the object.

Exceptions

ArgumentNullException

itemProperties is null.

Remarks

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.