IDbDataAdapter.DeleteCommand Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

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

public:
 property System::Data::IDbCommand ^ DeleteCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };

public System.Data.IDbCommand? DeleteCommand { get; set; }

member this.DeleteCommand : System.Data.IDbCommand with get, set

Public Property DeleteCommand As IDbCommand

Eigenschaftswert

IDbCommand

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

Beispiele

Im folgenden Beispiel wird eine instance der geerbten OleDbDataAdapter Klasse erstellt und die SelectCommand Eigenschaften und DeleteCommand festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OleDbConnection -Objekt erstellt haben.

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

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

    Dim dataAdapter As 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

Hinweise

Wenn diese UpdateEigenschaft nicht festgelegt ist und Primärschlüsselinformationen im DataSetvorhanden sind, kann automatisch DeleteCommand 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. Diese Generierungslogik erfordert, dass wichtige Spalteninformationen im DataSetvorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilders.

Wenn DeleteCommand einem zuvor erstellten IDbCommandzugewiesen wird, wird der IDbCommand nicht geklont. Der DeleteCommand verwaltet einen Verweis auf das zuvor erstellte IDbCommand -Objekt.