OleDbDataAdapter.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.OleDb
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Property InsertCommand As OleDbCommand
'Usage
Dim instance As OleDbDataAdapter
Dim value As OleDbCommand

value = instance.InsertCommand

instance.InsertCommand = value

public OleDbCommand InsertCommand { get; set; }

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

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

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

public function get InsertCommand () : OleDbCommand

public function set InsertCommand (value : OleDbCommand)

Eigenschaftenwert

Ein OleDbCommand, der während der Ausführung von Update zum Einfügen von Datensätzen in die Datenquelle verwendet wird, die den neuen Zeilen im DataSet entsprechen.

Hinweise

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

Wenn InsertCommand einem zuvor erstellten OleDbCommand zugeordnet wird, wird der OleDbCommand nicht geklont. Der InsertCommand verwaltet einen Verweis auf das zuvor erstellte OleDbCommand-Objekt.

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 Sie die UpdatedRowSource-Eigenschaft des OleDbCommand-Objekts festlegen.

Beispiel

Im folgenden Beispiel werden ein OleDbDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die InsertCommand-Eigenschaft festgelegt. Es wird davon ausgegangen, dass bereits ein OleDbConnection-Objekt erstellt wurde.

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 
  
    Dim adapter As OleDbDataAdapter = New OleDbDataAdapter()
    Dim command As OleDbCommand

    ' 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)

    adapter.SelectCommand = command

    ' Create the InsertCommand.
    command = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
        "VALUES (?, ?)", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.InsertCommand = command
    Return adapter
End Function

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter();
    OleDbCommand command;

    // 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);

    adapter.SelectCommand = command;

    // Create the InsertCommand.
    command = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    adapter.InsertCommand = command;
    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, 1.0

Siehe auch

Referenz

OleDbDataAdapter-Klasse
OleDbDataAdapter-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit DataAdapters