IDbDataAdapter.DeleteCommand-Eigenschaft

Ruft eine SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset ab oder legt diese fest.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Property DeleteCommand As IDbCommand
'Usage
Dim instance As IDbDataAdapter
Dim value As IDbCommand

value = instance.DeleteCommand

instance.DeleteCommand = value

IDbCommand DeleteCommand { get; set; }

property IDbCommand^ DeleteCommand {
    IDbCommand^ get ();
    void set (IDbCommand^ value);
}

/** @property */
IDbCommand get_DeleteCommand ()

/** @property */
void set_DeleteCommand (IDbCommand value)

function get DeleteCommand () : IDbCommand

function set DeleteCommand (value : IDbCommand)

Eigenschaftenwert

Ein IDbCommand, der während der Ausführung von Update verwendet wird, um Datensätze in der Datenquelle zu löschen, die gelöschten Zeilen im Dataset entsprechen.

Hinweise

Während der Ausführung von Update kann, wenn diese Eigenschaft nicht festgelegt ist und Primärschlüsselinformationen im DataSet vorhanden sind, der DeleteCommand automatisch generiert werden, wenn Sie die SelectCommand-Eigenschaft eines .NET Framework-Datenanbieters festlegen. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, vom CommandBuilder generiert. Für diese Generierungslogik müssen im DataSet Schlüsselspalteninformationen vorhanden sein. Weitere Informationen finden Sie unter Automatisches Generieren von Befehlen.

Wenn DeleteCommand einem zuvor erstellten IDbCommand zugeordnet wird, wird IDbCommand nicht geklont. Das DeleteCommand verwaltet einen Verweis auf das zuvor erstellte IDbCommand-Objekt.

Beispiel

Im folgenden Beispiel wird eine Instanz der vererbten OleDbDataAdapter-Klasse erstellt, und die SelectCommand-Eigenschaft sowie die DeleteCommand-Eigenschaft werden festgelegt. Es wird davon ausgegangen, dass bereits ein OleDbConnection-Objekt erstellt wurde.

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 

    Dim dataAdapter As OleDbDataAdapter = New OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT CustomerID FROM Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    dataAdapter.SelectCommand = command

    ' Create the DeleteCommand.
    command = New OleDbCommand( _
        "DELETE * FROM Customers WHERE CustomerID = ?", _
        connection)

    parameter = command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.DeleteCommand = command

    Return dataAdapter
End Function

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT CustomerID FROM Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    dataAdapter.SelectCommand = command;

    // Create the DeleteCommand.
    command = new OleDbCommand(
        "DELETE * FROM Customers WHERE CustomerID = ?", 
        connection);

    parameter = command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.DeleteCommand = command;

    return dataAdapter;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDbDataAdapter-Schnittstelle
IDbDataAdapter-Member
System.Data-Namespace