DetailsView.AutoGenerateDeleteButton Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der angibt, ob das integrierte Steuerelement zum Löschen des aktuellen Datensatzes in einem DetailsView-Steuerelement angezeigt 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, um das integrierte Steuerelement zum Löschen des aktuellen Datensatzes anzuzeigen, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateDeleteButton -Eigenschaft verwendet wird, um das integrierte Steuerelement zum Löschen des aktuellen Datensatzes anzuzeigen.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView AutoGenerateDeleteButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateDeleteButton Example</h3>
                
        <asp:detailsview id="CustomersDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
            ConnectionString=
              "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], 
              [CompanyName], [Address], [City], [PostalCode], [Country]) 
              VALUES (@CustomerID, @CompanyName, @Address, @City, 
              @PostalCode, @Country)"
            SelectCommand="Select [CustomerID], [CompanyName], 
              [Address], [City], [PostalCode], [Country] From 
              [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView AutoGenerateDeleteButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateDeleteButton Example</h3>
                
        <asp:detailsview id="CustomersDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
            ConnectionString=
              "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], 
              [CompanyName], [Address], [City], [PostalCode], [Country]) 
              VALUES (@CustomerID, @CompanyName, @Address, @City, 
              @PostalCode, @Country)"
            SelectCommand="Select [CustomerID], [CompanyName], 
              [Address], [City], [PostalCode], [Country] From 
              [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Hinweise

Wenn ein DetailsView Steuerelement an ein Objekt gebunden ist, das von DataSourceView erbt und die CanDelete -Eigenschaft zurückgibt true, kann das DetailsView Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Löschfunktionen bereitstellen.

Hinweis

Damit ein SqlDataSourceView Objekt Daten löschen kann, muss die SqlDataSource.DeleteCommand -Eigenschaft des zugrunde liegenden SqlDataSource Objekts mit einer delete-Abfrageanweisung festgelegt werden.

Wenn die AutoGenerateDeleteButton -Eigenschaft auf truefestgelegt ist, wird im DetailsView Steuerelement automatisch ein CommandField Zeilenfeld mit der Schaltfläche Löschen angezeigt. Durch Klicken auf die Schaltfläche Löschen wird dieser Datensatz endgültig aus der Datenquelle entfernt.

Hinweis

Sie müssen auch die DataKeyNames -Eigenschaft festlegen, damit das Feature für das automatische Löschen funktioniert.

Das DetailsView -Steuerelement stellt mehrere Ereignisse bereit, die Sie verwenden können, um eine benutzerdefinierte Aktion auszuführen, wenn ein Datensatz gelöscht wird. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.

Ereignis BESCHREIBUNG
ItemDeleted Tritt auf, wenn auf die Schaltfläche Löschen geklickt wird, aber nachdem das DetailsView Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Löschvorgangs zu überprüfen.
ItemDeleting Tritt auf, wenn auf die Schaltfläche Löschen geklickt wird, aber bevor das DetailsView Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um den Löschvorgang abzubrechen.

Der Wert von AutoGenerateDeleteButton wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen