OdbcDataAdapter.InsertCommand-Eigenschaft

Ruft eine SQL-Anweisung oder gespeicherte Prozedur ab, mit der neue Datensätze in die Datenquelle eingefügt werden, oder legt diese fest.

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

Syntax

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

value = instance.InsertCommand

instance.InsertCommand = value

public OdbcCommand InsertCommand { get; set; }

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

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

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

public function get InsertCommand () : OdbcCommand

public function set InsertCommand (value : OdbcCommand)

Eigenschaftenwert

Ein OdbcCommand, mit dem bei einem Aktualisierungsvorgang die Datensätze in die Datenquelle eingefügt werden, die den neuen Zeilen im DataSet entsprechen.

Hinweise

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

Wenn InsertCommand bei einem Aktualisierungsvorgang nicht festgelegt ist und im DataSet Primärschlüsselinformationen vorhanden sind, können Sie mithilfe der OdbcCommandBuilder-Klasse automatisch InsertCommand 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 das Ausführen dieses Befehls Zeilen zurückgegeben werden, können diese dem DataSet hinzugefügt werden. Dies ist davon abhängig, wie die .Data.Odbc.OdbcCommand.UpdatedRowSource-Eigenschaft des OdbcCommand-Objekts festgelegt ist.

Beispiel

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