GridView.AutoGenerateEditButton Eigenschaft

public:
 virtual property bool AutoGenerateEditButton { bool get(); void set(bool value); };

public virtual bool AutoGenerateEditButton { get; set; }

member this.AutoGenerateEditButton : bool with get, set

Public Overridable Property AutoGenerateEditButton As Boolean

Eigenschaftswert

Boolean

true, wenn eine CommandField-Feldspalte mit einer Schaltfläche Bearbeiten für jede Datenzeile automatisch hinzugefügt werden soll, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die AutoGenerateEditButton Eigenschaft zum Aktivieren des automatischen Bearbeitungsfeatures des GridView Steuerelements verwendet wird.

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

Hinweise

Wenn ein Datenquellensteuerelement, das die Aktualisierung unterstützt, an ein GridView Steuerelement gebunden ist, kann das GridView Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Aktualisierungsfunktionen bereitstellen.

Wenn die AutoGenerateEditButton Eigenschaft auf truefestgelegt ist, wird automatisch eine Spalte (dargestellt durch ein CommandField Objekt) mit einer Schaltfläche "Bearbeiten" für jede Datenzeile dem GridView Steuerelement hinzugefügt. Durch Klicken auf eine Schaltfläche "Bearbeiten" für eine Zeile wird diese Zeile im Bearbeitungsmodus platziert. Wenn sich eine Zeile im Bearbeitungsmodus befindet, zeigt jedes Spaltenfeld in der Zeile, das nicht schreibgeschützt ist, das entsprechende Eingabesteuerelement, z. B. ein TextBox Steuerelement, für den Datentyp des Felds an. Dadurch kann der Benutzer den Wert des Felds ändern.

Wenn Sie auf die Schaltfläche "Bearbeiten" geklickt haben, wird die Schaltfläche "Bearbeiten" auch durch eine Schaltfläche "Aktualisieren" und eine Schaltfläche "Abbrechen" ersetzt. Durch Klicken auf die Schaltfläche "Aktualisieren" wird die Zeile in der Datenquelle mit allen Wertänderungen aktualisiert und die Zeile in den Anzeigemodus zurückgegeben. Durch Klicken auf die Schaltfläche "Abbrechen" werden alle Wertänderungen abgebrochen und die Zeile zum Anzeigemodus zurückgegeben.

Wenn Sie die integrierte Aktualisierungsfunktionalität verwenden, müssen Sie die DataKeyNames Eigenschaft mit einer durch Trennzeichen getrennten Liste von Feldnamen festlegen, um das Primärschlüsselfeld oder die Felder der Datenquelle zu identifizieren. Andernfalls kann die integrierte Aktualisierungsfunktionalität den richtigen Datensatz nicht aktualisieren. Beim Verwenden automatisch generierter Feldspalten (durch Festlegen der AutoGenerateColumns Eigenschaft auf true) stellt das GridView Steuerelement automatisch sicher, dass die automatisch generierten Feldspalten, die dem in der DataKeyNames Eigenschaft angegebenen Feld oder Feldern entsprechen, schreibgeschützt sind.

Sie können die Darstellung einer Zeile steuern, die sich im Bearbeitungsmodus befindet, indem Sie die EditRowStyle Eigenschaft verwenden. Allgemeine Einstellungen enthalten in der Regel eine benutzerdefinierte Hintergrundfarbe, Vordergrundfarbe und Schriftarteigenschaften.

Das GridView Steuerelement stellt mehrere Ereignisse bereit, mit denen Sie eine benutzerdefinierte Aktion ausführen können, wenn eine Zeile aktualisiert wird. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.

Gilt für

Siehe auch

• CommandField
• AutoGenerateDeleteButton
• AutoGenerateSelectButton
• AutoGenerateColumns
• DataKeys
• DataKeyNames
• EditIndex
• EditRowStyle
• RowCancelingEdit
• RowEditing
• RowUpdated
• RowUpdating