OdbcDataAdapter.DeleteCommand-Eigenschaft

Ruft eine SQL-Anweisung oder eine gespeicherte Prozedur ab, um Datensätze in der Datenquelle zu löschen, oder legt diese fest.

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

Syntax

'Declaration
Public Property DeleteCommand As OdbcCommand
'Usage
Dim instance As OdbcDataAdapter
Dim value As OdbcCommand

value = instance.DeleteCommand

instance.DeleteCommand = value

public OdbcCommand DeleteCommand { get; set; }

public:
property OdbcCommand^ DeleteCommand {
    OdbcCommand^ get ();
    void set (OdbcCommand^ value);
}

/** @property */
public OdbcCommand get_DeleteCommand ()

/** @property */
public void set_DeleteCommand (OdbcCommand value)

public function get DeleteCommand () : OdbcCommand

public function set DeleteCommand (value : OdbcCommand)

Eigenschaftenwert

Ein OdbcCommand, mit dem bei einem Aktualisierungsvorgang die Datensätze aus der Datenquelle gelöscht werden, die den gelöschten Zeilen im DataSet entsprechen.

Hinweise

Wenn die DeleteCommand-Eigenschaft einem bereits erstellten OdbcCommand zugewiesen ist, wird OdbcCommand nicht geklont. Stattdessen verwaltet DeleteCommand einen Verweis auf den bereits erstellten OdbcCommand.

Wenn DeleteCommand bei einem Aktualisierungsvorgang nicht festgelegt ist und Primärschlüsselinformationen im DataSet vorhanden sind, können Sie mit der OdbcCommandBuilder-Klasse automatisch DeleteCommand und weitere Befehle zum Abstimmen von DataSet mit der Datenquelle generieren. Legen Sie hierzu die SelectCommand-Eigenschaft des OdbcDataAdapter fest. Für die Generierungslogik müssen außerdem im DataSet Schlüsselspalteninformationen vorhanden sein. Weitere Informationen finden Sie unter Automatisches Generieren von Befehlen.

Beispiel

Im folgenden Beispiel werden ein OdbcDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die DeleteCommand-Eigenschaft festgelegt. Es wird davon ausgegangen, dass bereits ein OdbcConnection-Objekt erstellt wurde.

Public Function CreateDataAdapter( _
    ByVal connection As OdbcConnection) As OdbcDataAdapter

    Dim selectCommand As String = _
        "SELECT CustomerID, CompanyName FROM Customers"
    Dim adapter As OdbcDataAdapter = _
        New OdbcDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the Insert, Update and Delete commands.
    adapter.InsertCommand = New OdbcCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OdbcCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OdbcCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OdbcType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OdbcType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OdbcType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

public static OdbcDataAdapter CreateDataAdapter(
    OdbcConnection connection)
{
    string selectCommand =
        "SELECT CustomerID, CompanyName FROM Customers";

    OdbcDataAdapter adapter = new OdbcDataAdapter(
        selectCommand, connection);
    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OdbcCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OdbcCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OdbcCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OdbcType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OdbcType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OdbcType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

OdbcDataAdapter-Klasse
OdbcDataAdapter-Member
System.Data.Odbc-Namespace

Weitere Ressourcen

Arbeiten mit DataAdapters