OdbcDataAdapter.UpdateCommand-Eigenschaft

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

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

Syntax

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

value = instance.UpdateCommand

instance.UpdateCommand = value

public OdbcCommand UpdateCommand { get; set; }

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

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

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

public function get UpdateCommand () : OdbcCommand

public function set UpdateCommand (value : OdbcCommand)

Eigenschaftenwert

Ein OdbcCommand, mit dem bei einem Aktualisierungsvorgang die Datensätze in der Datenquelle aktualisiert werden, die den geänderten Zeilen im DataSet entsprechen.

Hinweise

Wenn UpdateCommand einem zuvor erstellten OdbcCommand zugeordnet wird, wird der OdbcCommand nicht geklont. Stattdessen verwaltet UpdateCommand einen Verweis auf das bereits erstellte OdbcCommand-Objekt.

Wenn UpdateCommand bei einem Aktualisierungsvorgang nicht festgelegt ist und im DataSet Primärschlüsselinformationen vorhanden sind, können Sie mithilfe der OdbcCommandBuilder-Klasse automatisch UpdateCommand 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.

Hinweis

Wenn durch die Ausführung dieses Befehls Zeilen zurückgegeben werden, können diese mit dem DataSet zusammengeführt werden. Dies ist davon abhängig, wie Sie die .Data.Odbc.OdbcCommand.UpdatedRowSource-Eigenschaft des OdbcCommand-Objekts festlegen.

Beispiel

Im folgenden Beispiel werden ein OdbcDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die UpdateCommand-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