AutoGenerateColumns Property

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.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual bool AutoGenerateColumns { get; set; }

Property Value

Type: System.Boolean

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.

Data Type



A primitive data type, such as System.Int32, Char, Double, and so on. For a complete list, see Type.IsPrimitive.


A System.String object.


A System.DateTime object.


A System.Decimal object.


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.

The following code example demonstrates how to use the AutoGenerateColumns property to automatically create a BoundColumn object for each field in the data source.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="" >

   <script language="C#" runat="server">

      ICollection CreateDataSource() 
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);


         DataView dv = new DataView(dt);
         return dv;

      void Page_Load(Object sender, EventArgs e) 

         if (!IsPostBack) 
            // Need to load this data only once.
            ItemsGrid.DataSource= CreateDataSource();


<head runat="server">
    <title>DataGrid AutoGenerateColumns Example</title>

   <form id="form1" runat="server">

      <h3>DataGrid AutoGenerateColumns Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"

         <HeaderStyle BackColor="#00aaaa">




.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft