DataGrid.AutoGenerateColumns Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of BoundColumn objecten automatisch worden gemaakt en weergegeven in het DataGrid besturingselement voor elk veld in de gegevensbron.

public:
 virtual property bool AutoGenerateColumns { bool get(); void set(bool value); };
public virtual bool AutoGenerateColumns { get; set; }
member this.AutoGenerateColumns : bool with get, set
Public Overridable Property AutoGenerateColumns As Boolean

Waarde van eigenschap

Boolean

true als BoundColumn objecten automatisch worden gemaakt en weergegeven; falseanders. De standaardwaarde is true.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AutoGenerateColumns eigenschap gebruikt om automatisch een BoundColumn object te maken voor elk veld in de gegevensbron.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

   <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);
   
            dt.Rows.Add(dr);
         }
 
         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();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>DataGrid AutoGenerateColumns Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid AutoGenerateColumns Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

   <script language="VB" runat="server">
     Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " & i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Need to load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
 
   </script>
 
<head runat="server">
    <title>DataGrid AutoGenerateColumns Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid AutoGenerateColumns Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

      </asp:DataGrid>
 
   </form>
 
</body>
</html>

Opmerkingen

Gebruik deze eigenschap om automatisch een BoundColumn object te maken voor elk veld in de gegevensbron. Elk veld wordt vervolgens weergegeven als een kolom in het DataGrid besturingselement in de volgorde waarin de velden worden weergegeven in de gegevensbron.

Niet alle gegevenstypen kunnen worden gebonden aan het DataGrid besturingselement. Als een veld een niet-ondersteund gegevenstype bevat, wordt er geen kolom voor dat veld gemaakt. Als de gegevensbron slechts één kolom met een niet-ondersteund gegevenstype bevat, wordt er een uitzondering gegenereerd. In de volgende tabel ziet u de gegevenstypen die aan het besturingselement kunnen worden gekoppeld.

Gegevenssoort Beschrijving
Primitives Een primitief gegevenstype, zoals System.Int32, Char, Doubleenzovoort. Zie voor een volledige lijst Type.IsPrimitive.
String Een System.String-object.
DateTime Een System.DateTime-object.
Decimaal Een System.Decimal-object.

Note

Expliciet gedeclareerde kolommen kunnen worden gebruikt in combinatie met automatisch gegenereerde kolommen. Wanneer u beide gebruikt, worden expliciet gedeclareerde kolommen eerst weergegeven, gevolgd door de automatisch gegenereerde kolommen. Automatisch gegenereerde kolommen worden niet toegevoegd aan de Columns verzameling.

Van toepassing op

Zie ook