Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

SqlDataSource.Delete-Methode

.NET Framework 4.5

Andere Versionen

Führt mithilfe der DeleteCommand-SQL-Zeichenfolge und allen Parametern, die in der DeleteParameters-Auflistung vorhanden sind, einen Löschvorgang aus.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public int Delete()

Rückgabewert

Typ: System.Int32
Ein Wert, der die Anzahl der Zeilen darstellt, die aus der zugrunde liegenden Datenbank gelöscht wurden.

Ausnahmen

Ausnahme	Bedingung
InvalidOperationException	Die SqlDataSource kann keine Verbindung mit der zugrunde liegenden Datenquelle herstellen.

Hinweise

Vor dem Ausführen des Löschvorgangs wird die OnDeleting-Methode aufgerufen, um das Deleting-Ereignis auszulösen. Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und eine Verarbeitung vor einem Löschvorgang auszuführen.

Nach Abschluss des Vorgangs wird die OnDeleted-Methode aufgerufen, um das Deleted-Ereignis auszulösen. Sie können eine Ereignisbehandlung definieren, mit der Sie Rückgabewerte und Fehlercodes überprüfen und eine möglicherweise erforderliche Nachbearbeitung durchführen können.

Die Delete-Methode wird für den programmgesteuerten Zugriff auf die Delete-Methode bereitgestellt. Wenn das SqlDataSource-Steuerelement einem datengebundenen Steuerelement zugeordnet ist, ruft das datengebundene Steuerelement automatisch die Delete-Methode auf.

Die Delete-Methode wird an die Delete-Methode des SqlDataSourceView-Objekts delegiert, das dem SqlDataSource-Steuerelement zugeordnet ist. Zum Ausführen dieses Vorgangs erstellt die SqlDataSourceView unter Verwendung des DeleteCommand-Texts und allen zugeordneten DeleteParameters-Werten ein DbCommand-Objekt und führt dann den DbCommand für die zugrunde liegende Datenbank aus.

Topic	Location
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen	Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen	Erstellen von ASP.NET-Webanwendungen in Visual Studio

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der DeleteCommand-Text festgelegt wird, um eine Bestellung aus der Datenbank Northwind zu löschen. Zunächst werden die Daten aus der Tabelle Bestellungen abgerufen und in einem DropDownList-Steuerelement angezeigt. Sie müssen die DeleteParameters-Eigenschaft explizit deklarieren und die Delete-Methode aufrufen, wenn Sie datengebundene Steuerelemente, z. B. DropDownList, verwenden (im Gegensatz zu anderen Steuerelementen wie beispielsweise GridView und DetailsView, die die Parameter automatisch füllen und die Delete-Methode eines Datenquellen-Steuerelements aufrufen). In diesem Beispiel wird das OnClick-Ereignis an den privaten OnDelete-Ereignishandler delegiert, der die Delete-Methode des SqlDataSource-Steuerelements explizit aufruft.


<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void OnDelete(Object sender, EventArgs e) {
    SqlDataSource1.Delete();
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT OrderID FROM Orders"
                DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;">
                <DeleteParameters>
                    <asp:ControlParameter Name="OrderID" ControlId="DropDownList1" PropertyName="SelectedValue" />
                </DeleteParameters>
            </asp:SqlDataSource>

            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                DataTextField="OrderID"
                DataValueField="OrderID"
                DataSourceID="SqlDataSource1">
            </asp:DropDownList>

            <asp:Button
                id="Button1"
                runat="server"
                Text="Delete Order"
                OnClick="OnDelete">
            </asp:Button>

        </form>
    </body>
</html>

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Siehe auch

Referenz

SqlDataSource Klasse

System.Web.UI.WebControls-Namespace

DeleteCommand

DeleteParameters

Weitere Ressourcen

ASP.NET Data Access Overview

Data Source Web Server Controls

SqlDataSource Web Server Control Overview

ASP.NET Page Life Cycle Overview

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN