GridView.AutoGenerateColumns-Eigenschaft

Wenn die AutoGenerateColumns-Eigenschaft auf true festgelegt ist, wird für jedes Feld in der Datenquelle automatisch ein AutoGeneratedField-Objekt erstellt. Daraufhin werden die Felder in derselben Reihenfolge, in der sie in der Datenquelle angegeben sind, jeweils als Spalte im GridView-Steuerelement angezeigt. Diese Option ermöglicht in unkomplizierter Weise, die einzelnen Felder der Datenquelle anzuzeigen. Allerdings kann die Anzeige und das Verhalten eines automatisch generierten Spaltenfelds nur in begrenztem Maße gesteuert werden.

Anstatt Spaltenfelder mithilfe des GridView-Steuerelements automatisch zu generieren, können sie manuell definiert werden, indem Sie die AutoGenerateColumns-Eigenschaft auf false festlegen und anschließend eine benutzerdefinierte Columns-Auflistung erstellen. Zusätzlich zu den gebundenen Spaltenfeldern können Sie auch ein Schaltflächenspalten-Feld, ein Kontrollkästchenspalten-Feld, ein Befehlsfeld, ein Linkspalten-Feld, ein Bildfeld oder ein auf einer benutzerdefinierten Vorlage basierendes Spaltenfeld anzeigen.

Sie können explizit deklarierte Spaltenfelder mit automatisch generierten Spaltenfeldern auch kombinieren. Wenn Sie beide Spaltenfeldarten verwenden, werden zuerst die explizit deklarierten Spaltenfelder und anschließend die automatisch generierten Spaltenfelder gerendert. Automatisch generierte gebundene Spaltenfelder werden nicht zur Columns-Auflistung hinzugefügt. Weitere Informationen finden Sie unter Columns.

Wenn legen Sie diese Eigenschaft auf festlegen true und die ItemType-Eigenschaft zu einem Modelltyp, DynamicField-Steuerelemente werden generiert fest. Wenn Sie nicht die ItemType-Eigenschaft festlegen, werden BoundField-Steuerelemente generiert. Wenn Sie nicht DynamicField-Steuerelemente möchten, haben Sie folgende Möglichkeiten:

• Legen Sie die - Eigenschaft auf ColumnsGeneratornull im Page_Load-Ereignishandler fest. In diesem Fall werden BoundField-Steuerelemente generiert.

• Schreiben Sie benutzerdefinierten Code, um Felder automatisch generieren, indem Sie eine Instanz davon in den Steuerelement erstellen und weisen eine eigene ColumnsGenerator-Klasse und zuweisen.

• Setzen Sie AutoGenerateColumns auf false. In diesem Fall werden keine Felder generiert, und Sie müssen Felder mithilfe der Steuerelemente wie BoundField oder ImageField manuell angeben.

• Legen Sie die ItemType-Eigenschaft nicht fest. In diesem Fall werden BoundField-Steuerelemente generiert.

Im folgenden Beispiel wird veranschaulicht, wie für die einzelnen Felder der Datenquelle mithilfe der AutoGenerateColumns-Eigenschaft gebundene Feldspalten in einem GridView-Steuerelement automatisch erstellt werden.

<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz