GridView.AutoGenerateColumns Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of afhankelijke velden automatisch worden gemaakt 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, setPublic Overridable Property AutoGenerateColumns As BooleanWaarde van eigenschap
true om automatisch afhankelijke velden te maken voor elk veld in de gegevensbron; anders, false. De standaardwaarde is true.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de AutoGenerateColumns eigenschap gebruikt om automatisch afhankelijke veldkolommen te maken in een GridView besturingselement voor elk veld in de gegevensbron.
<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>
<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>
Opmerkingen
Wanneer de AutoGenerateColumns eigenschap is ingesteld op true, wordt er automatisch een AutoGeneratedField object gemaakt voor elk veld in de gegevensbron. Elk veld wordt vervolgens weergegeven als een kolom in het GridView besturingselement in de volgorde waarin de velden worden weergegeven in de gegevensbron. Deze optie biedt een handige manier om elk veld in de gegevensbron weer te geven; U hebt echter beperkte controle over hoe een automatisch gegenereerd kolomveld wordt weergegeven of zich gedraagt.
In plaats van het GridView besturingselement automatisch de kolomvelden te laten genereren, kunt u de kolomvelden handmatig definiëren door de AutoGenerateColumns eigenschap in te false stellen op en vervolgens een aangepaste verzameling te Columns maken. Naast afhankelijke kolomvelden kunt u ook een knopkolomveld, een veld met selectievakjekolom, een opdrachtveld, een hyperlinkkolomveld, een afbeeldingsveld of een kolomveld weergeven op basis van uw eigen aangepaste sjabloon.
U kunt ook expliciet gedeclareerde kolomvelden combineren met automatisch gegenereerde kolomvelden. Wanneer beide worden gebruikt, worden expliciet gedeclareerde kolomvelden eerst weergegeven, gevolgd door de automatisch gegenereerde kolomvelden. Automatisch gegenereerde afhankelijke kolomvelden worden niet toegevoegd aan de Columns verzameling. Zie Columns voor meer informatie.
Als u deze eigenschap true instelt op en de ItemType eigenschap instelt op een modeltype, DynamicField worden besturingselementen gegenereerd. Als u de ItemType eigenschap niet instelt, BoundField worden besturingselementen gegenereerd. Als u geen besturingselementen wilt DynamicField , hebt u de volgende opties:
Stel de eigenschap ColumnsGenerator in op
nullPage_Loadde gebeurtenis-handler. In dat geval BoundField worden besturingselementen gegenereerd.Schrijf aangepaste code om automatisch velden te genereren door uw eigen ColumnsGenerator klasse te maken en toe te wijzen en er een exemplaar van toe te wijzen aan het besturingselement.
Stel AutoGenerateColumns in op
false. In dat geval worden er geen velden gegenereerd en moet u handmatig velden opgeven met behulp van besturingselementen zoals BoundField of ImageField.Stel de ItemType eigenschap niet in. In dat geval BoundField worden besturingselementen gegenereerd.
