This documentation is archived and is not being maintained.

DataGrid.AutoGenerateColumns Property

Gets or sets a value that indicates whether BoundColumn objects are automatically created and displayed in the DataGrid control for each field in the data source.

[Visual Basic]
Public Overridable Property AutoGenerateColumns As Boolean
public virtual bool AutoGenerateColumns {get; set;}
public: __property virtual bool get_AutoGenerateColumns();
public: __property virtual void set_AutoGenerateColumns(bool);
public function get AutoGenerateColumns() : Boolean;
public function set AutoGenerateColumns(Boolean);

Property Value

true if BoundColumn objects are automatically created and displayed; otherwise, false. The default value is true.


Use this property to automatically create a BoundColumn object for each field in the data source. Each field is then rendered as a column in the DataGrid control in the order that the fields appear in the data source.

Not all data types can be bound to the DataGrid control. If a field contains an unsupported data type, a column is not created for that field. If the data source only contains one column with an unsupported data type, an exception is thrown. The following table shows the data types that can be bound to the control.

Date Type Description
Primitives A primitive data type, such as System.Int32, Char, Double, and so on. For a complete list, see Type.IsPrimitive.
String A System.String object.
DateTime A System.DateTime object.
Decimal A System.Decimal object.
Note   Explicitly declared columns may be used in conjunction with auto-generated columns. When using both, explicitly declared columns will be rendered first, followed by the auto-generated columns. Auto-generated columns are not added to the Columns collection.


Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

DataGrid Class | DataGrid Members | System.Web.UI.WebControls Namespace | BoundColumn | Columns | Type.IsPrimitive | System.String | System.DateTime | System.Decimal