OdbcDataAdapter.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.
Dient zum Abrufen oder Festlegen einer SQL-Anweisung oder einer gespeicherten Prozedur, die zum Einfügen neuer Datensätze in die Datenquelle verwendet wird.
public:
property System::Data::Odbc::OdbcCommand ^ InsertCommand { System::Data::Odbc::OdbcCommand ^ get(); void set(System::Data::Odbc::OdbcCommand ^ value); };public System.Data.Odbc.OdbcCommand? InsertCommand { get; set; }public System.Data.Odbc.OdbcCommand InsertCommand { get; set; }member this.InsertCommand : System.Data.Odbc.OdbcCommand with get, setPublic Property InsertCommand As OdbcCommandEigenschaftswert
Wird OdbcCommand während eines Aktualisierungsvorgangs zum Einfügen von Datensätzen in die Datenquelle verwendet, die neuen Zeilen in der DataSetDatenquelle entsprechen.
Beispiele
Im folgenden Beispiel wird eine OdbcDataAdapter und die SelectCommand Eigenschaften erstellt und InsertCommand festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OdbcConnection Objekt erstellt haben.
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;
}
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
Hinweise
Wenn die InsertCommand Eigenschaft einem zuvor erstellten OdbcCommand Objekt zugewiesen ist, wird die OdbcCommand Eigenschaft nicht geklont. InsertCommand Verwaltet stattdessen einen Verweis auf die zuvor erstellte OdbcCommand.
Bei einem Aktualisierungsvorgang können Sie, wenn InsertCommand sie nicht festgelegt ist und Primärschlüsselinformationen in der DataSetKlasse vorhanden sind, die Klasse verwenden OdbcCommandBuilder , um automatisch zu generieren InsertCommand, und zusätzliche Befehle, die erforderlich sind, um die DataSet Datenquelle abzugleichen. Legen Sie dazu die SelectCommand Eigenschaft der OdbcDataAdapter. Für die Generierungslogik sind außerdem wichtige Spalteninformationen erforderlich, die DataSetim Bereich vorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.
Hinweis
Wenn die Ausführung dieses Befehls Zeilen zurückgibt, können diese Zeilen abhängig davon hinzugefügt DataSet werden, wie Sie die UpdatedRowSource Eigenschaft des OdbcCommand Objekts festlegen.
