GridView.AutoGenerateDeleteButton Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob für jede Datenzeile automatisch eine CommandField-Feldspalte mit einer Schaltfläche Löschen zu einem GridView-Steuerelement hinzugefügt wird, oder legt diesen Wert fest.Gets or sets a value indicating whether a CommandField field column with a Delete button for each data row is automatically added to a GridView control.

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

Eigenschaftswert

true, wenn eine CommandField-Feldspalte mit einer Schaltfläche Löschen für jede Datenzeile automatisch hinzugefügt werden soll, andernfalls false.true to automatically add a CommandField field column with a Delete button for each data row; otherwise, false. Die Standardeinstellung ist false.The default is false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AutoGenerateDeleteButton -Eigenschaft verwendet wird, um die Funktion zum GridView automatischen Löschen eines-Steuer Elements zu aktivieren.The following example demonstrates how to use the AutoGenerateDeleteButton property to enable the automatic deleting feature of a GridView control.

<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 Datenquellen Steuerelement, das das Löschen unterstützt GridView , an ein GridView Steuerelement gebunden ist, kann das Steuerelement die Funktionen des Datenquellen-Steuer Elements nutzen und automatische Löschfunktionen bereitstellen.When a data source control that supports deleting is bound to a GridView control, the GridView control can take advantage of the data source control's capabilities and provide automatic deleting functionality.

Hinweis

Damit ein Datenquellen-Steuerelement Daten löschen kann, muss es zum Löschen von Daten konfiguriert werden.For a data source control to delete data, it must be configured to delete data. Informationen zum Konfigurieren eines Datenquellen-Steuer Elements zum Löschen von Datensätzen finden Sie in der Dokumentation für das jeweilige Datenquellen-Steuerelement.To configure a data source control to delete records, see the documentation for the specific data source control.

Wenn die AutoGenerateDeleteButton -Eigenschaft auf truefestgelegt ist, wird dem GridView -Steuer CommandField Element automatisch eine Spalte (durch ein-Objekt dargestellt) mit einer Schaltfläche Löschen für jede Daten Zeile hinzugefügt.When the AutoGenerateDeleteButton property is set to true, a column (represented by a CommandField object) with a Delete button for each data row is automatically added to the GridView control. Wenn Sie auf die Schaltfläche Löschen für eine Zeile klicken, wird dieser Datensatz endgültig aus der Datenquelle entfernt.Clicking the Delete button for a row permanently removes that record from the data source.

Hinweis

Sie müssen auch die DataKeyNames -Eigenschaft festlegen, um das Schlüsselfeld oder die Felder der Datenquelle zu identifizieren, damit das Feature zum automatischen Löschen funktioniert.You must also set the DataKeyNames property to identify the key field or fields of the data source for the automatic deleting feature to work.

Das GridView -Steuerelement stellt mehrere Ereignisse bereit, die Sie verwenden können, um eine benutzerdefinierte Aktion auszuführen, wenn eine Zeile gelöscht wird.The GridView control provides several events that you can use to perform a custom action when a row is deleted. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.The following table lists the available events.

eventEvent BeschreibungDescription
RowDeleted Tritt auf, wenn auf die Schaltfläche Löschen einer Zeile geklickt wird GridView , aber nachdem das-Steuerelement den Datensatz aus der Datenquelle gelöscht hat.Occurs when a row's Delete button is clicked, but after the GridView control deletes the record from the data source. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Löschvorgangs zu überprüfen.This event is often used to check the results of the delete operation.
RowDeleting Tritt auf, wenn auf die Schaltfläche Löschen einer Zeile geklickt wird GridView , jedoch bevor das-Steuerelement den Datensatz aus der Datenquelle löscht.Occurs when a row's Delete button is clicked, but before the GridView control deletes the record from the data source. Dieses Ereignis wird häufig verwendet, um den Löschvorgang abzubrechen.This event is often used to cancel the deleting operation.

Gilt für:

Siehe auch