DetailsView.AutoGenerateDeleteButton Eigenschaft
Definition
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 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, setPublic Overridable Property AutoGenerateDeleteButton As BooleanEigenschaftswert
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.
