OleDbDataAdapter.InsertCommand Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine zum Einfügen neuer Datensätze in die Datenquelle verwendete SQL-Anweisung oder gespeicherte Prozedur ab oder legt diese fest.
public:
property System::Data::OleDb::OleDbCommand ^ InsertCommand { System::Data::OleDb::OleDbCommand ^ get(); void set(System::Data::OleDb::OleDbCommand ^ value); };
public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }
public System.Data.OleDb.OleDbCommand? InsertCommand { get; set; }
[System.Data.DataSysDescription("DbDataAdapter_InsertCommand")]
public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set
[<System.Data.DataSysDescription("DbDataAdapter_InsertCommand")>]
member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set
Public Property InsertCommand As OleDbCommand
Eigenschaftswert
Ein OleDbCommand, der während der Ausführung von Update(DataSet) zum Einfügen von Datensätzen in die Datenquelle verwendet wird, die den neuen Zeilen im DataSet entsprechen.
- Attribute
Beispiele
Im folgenden Beispiel wird eine OleDbDataAdapter und InsertCommand die SelectCommand Eigenschaften erstellt und festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OleDbConnection Objekt erstellt haben.
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;
}
Public Shared Function CreateCustomerAdapter( _
connection As OleDbConnection) As OleDbDataAdapter
Dim adapter As 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
Hinweise
Wenn Updatediese Eigenschaft nicht festgelegt ist und Primärschlüsselinformationen im DataSetBereich vorhanden sind, kann dies InsertCommand automatisch generiert werden, wenn Sie die Eigenschaft festlegen und die SelectCommand OleDbCommandBuilderEigenschaft verwenden. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, vom OleDbCommandBuilder. Diese Generationslogik erfordert wichtige Spalteninformationen, die im DataSetBereich vorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.
Wenn InsertCommand einem zuvor erstellten Element OleDbCommandzugewiesen wird, wird dies OleDbCommand nicht geklont. Der InsertCommand Verwaltet einen Verweis auf das zuvor erstellte OleDbCommand Objekt.
Hinweis
Wenn die Ausführung dieses Befehls Zeilen zurückgibt, werden DataSet diese Zeilen je nachdem hinzugefügt, wie Sie die UpdatedRowSource Eigenschaft des OleDbCommand Objekts festlegen.