GridView.AutoGenerateDeleteButton Eigenschap

Definitie

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

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een CommandField veldkolom met een knop Verwijderen voor elke gegevensrij automatisch wordt toegevoegd aan een GridView besturingselement.

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

Waarde van eigenschap

Boolean

true om automatisch een CommandField veldkolom toe te voegen met een knop Verwijderen voor elke gegevensrij; falseanders. De standaardwaarde is false.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de AutoGenerateDeleteButton eigenschap gebruikt om de functie voor automatisch verwijderen van een GridView besturingselement in te schakelen.

<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>

Opmerkingen

Wanneer een besturingselement voor gegevensbronnen dat ondersteuning biedt voor verwijderen afhankelijk is van een GridView besturingselement, kan het GridView besturingselement profiteren van de mogelijkheden van het besturingselement voor gegevensbronnen en automatische verwijderingsfunctionaliteit bieden.

Note

Als u gegevens wilt verwijderen met een besturingselement voor gegevensbronnen, moet dit zijn geconfigureerd om gegevens te verwijderen. Als u een besturingselement voor gegevensbronnen wilt configureren om records te verwijderen, raadpleegt u de documentatie voor het specifieke besturingselement voor gegevensbronnen.

Wanneer de AutoGenerateDeleteButton eigenschap is ingesteld op true, wordt automatisch een kolom (vertegenwoordigd door een CommandField object) met een knop Verwijderen voor elke gegevensrij toegevoegd aan het GridView besturingselement. Als u op de knop Verwijderen klikt voor een rij, wordt die record definitief uit de gegevensbron verwijderd.

Note

U moet ook de DataKeyNames eigenschap instellen om het sleutelveld of de sleutelvelden van de gegevensbron te identificeren, zodat de functie voor automatisch verwijderen werkt.

Het GridView besturingselement bevat verschillende gebeurtenissen die u kunt gebruiken om een aangepaste actie uit te voeren wanneer een rij wordt verwijderd. De volgende tabel bevat de beschikbare gebeurtenissen.

Gebeurtenis Beschrijving
RowDeleted Treedt op wanneer op de knop Verwijderen van een rij wordt geklikt, maar nadat het GridView besturingselement de record uit de gegevensbron heeft verwijderd. Deze gebeurtenis wordt vaak gebruikt om de resultaten van de verwijderbewerking te controleren.
RowDeleting Treedt op wanneer op de knop Verwijderen van een rij wordt geklikt, maar voordat het GridView besturingselement de record uit de gegevensbron verwijdert. Deze gebeurtenis wordt vaak gebruikt om de verwijderingsbewerking te annuleren.

Van toepassing op

Zie ook