GridView.AutoGenerateDeleteButton Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

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

Boolean

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die AutoGenerateDeleteButton Eigenschaft verwenden, um das automatische Löschenfeature eines GridView Steuerelements zu aktivieren.

<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 das Löschen unterstützt, an ein GridView Steuerelement gebunden ist, kann das GridView Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Löschenfunktionen bereitstellen.

Hinweis

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

Wenn die AutoGenerateDeleteButton Eigenschaft auf truefestgelegt ist, wird eine Spalte (dargestellt durch ein CommandField Objekt) mit einer Schaltfläche "Löschen" für jede Datenzeile automatisch dem GridView Steuerelement hinzugefügt. Durch Klicken auf die Schaltfläche "Löschen" für eine Zeile wird dieser Datensatz endgültig aus der Datenquelle entfernt.

Hinweis

Sie müssen auch die DataKeyNames Eigenschaft festlegen, um das Schlüsselfeld oder die Felder der Datenquelle für das automatische Löschen zu identifizieren.

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

Ereignis BESCHREIBUNG
RowDeleted Tritt auf, wenn die Schaltfläche "Löschen" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Löschvorgangs zu überprüfen.
RowDeleting Tritt auf, wenn die Schaltfläche "Löschen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um den Löschenvorgang abzubrechen.

Gilt für

Siehe auch