OdbcDataAdapter.InsertCommand Właściwość

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

System.Data.Odbc v9.0.0-rc.2.24473.5

Źródło:

OdbcDataAdapter.cs

Pobiera lub ustawia instrukcję SQL lub procedurę składowaną używaną do wstawiania nowych rekordów do źródła danych.

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; }

member this.InsertCommand : System.Data.Odbc.OdbcCommand with get, set

Public Property InsertCommand As OdbcCommand

Wartość właściwości

OdbcCommand

Element OdbcCommand używany podczas operacji aktualizacji do wstawiania rekordów w źródle danych, które odpowiadają nowym wierszom w obiekcie DataSet.

Przykłady

Poniższy przykład tworzy obiekt OdbcDataAdapter i ustawia SelectCommand właściwości i InsertCommand . Przyjęto założenie, że obiekt został już utworzony OdbcConnection .

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

Uwagi

Gdy właściwość jest przypisana InsertCommand do wcześniej utworzonego OdbcCommand obiektu, OdbcCommand obiekt nie jest klonowany. InsertCommand Zamiast tego utrzymuje odwołanie do wcześniej utworzonego elementu OdbcCommand.

Jeśli podczas operacji aktualizacji nie ustawiono, a InsertCommand informacje o kluczu podstawowym znajdują się w elemecie DataSet, możesz użyć OdbcCommandBuilder klasy do automatycznego generowania InsertCommandpoleceń i dodatkowych poleceń potrzebnych do uzgodnienia DataSet źródła danych. W tym celu ustaw SelectCommand właściwość OdbcDataAdapter. Logika generowania wymaga również obecności informacji o kolumnie klucza w obiekcie DataSet. Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą konstruktorów poleceń.

Uwaga

Jeśli wykonanie tego polecenia zwraca wiersze, te wiersze mogą być dodawane do DataSet elementu w zależności od sposobu ustawiania UpdatedRowSource właściwości OdbcCommand obiektu.

Zobacz też

• Elementy DataAdapter i DataReader