GridView.AutoGenerateEditButton Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob für jede Datenzeile automatisch eine CommandField-Feldspalte mit einer Schaltfläche Bearbeiten zu einem GridView-Steuerelement hinzugefügt wird, oder legt diesen Wert fest.

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.

Hinweis

Für ein Datenquellensteuerelement zum Aktualisieren von Daten muss es so konfiguriert werden, dass Daten aktualisiert werden. Informationen zum Konfigurieren eines Datenquellensteuerelements zum Aktualisieren von Datensätzen finden Sie in der Dokumentation für das bestimmte Datenquellensteuerelement.

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.

Hinweis

Sie können eine Zeile programmgesteuert im Bearbeitungsmodus platzieren, indem Sie die EditIndex Eigenschaft mit dem Index der Zeile festlegen. Um den Bearbeitungsmodus programmgesteuert zu beenden, legen Sie die EditIndex Eigenschaft auf -1 fest.

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.

Ereignis	BESCHREIBUNG
RowCancelingEdit	Tritt auf, wenn auf die Schaltfläche "Abbrechen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement den Bearbeitungsmodus abbricht. Dieses Ereignis wird häufig verwendet, um den Abbruchvorgang zu beenden.
RowEditing	Tritt ein, wenn auf die Schaltfläche Bearbeiten einer Zeile geklickt wird, allerdings bevor das GridView-Steuerelement tatsächlich in den Bearbeitungsmodus wechselt. Dieses Ereignis wird häufig verwendet, um den Bearbeitungsvorgang abzubrechen.
RowUpdated	Tritt ein, wenn auf die Schaltfläche Aktualisieren einer Zeile geklickt wird, allerdings nachdem dasGridView-Steuerelement die Zeile aktualisiert hat. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Aktualisierungsvorgangs zu überprüfen.
RowUpdating	Tritt ein, wenn auf die Schaltfläche Aktualisieren einer Zeile geklickt wird, allerdings bevor das GridView-Steuerelement die Zeile tatsächlich aktualisiert. Dieses Ereignis wird häufig verwendet, um den Aktualisierungsvorgang abzubrechen.

Gilt für