IDbDataAdapter.InsertCommand Właściwość

Definicja

Przestrzeń nazw:

System.Data

Zestawy:

netstandard.dll, System.Data.Common.dll

Źródło:

IDbDataAdapter.cs

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

public:
 property System::Data::IDbCommand ^ InsertCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };

public System.Data.IDbCommand? InsertCommand { get; set; }

member this.InsertCommand : System.Data.IDbCommand with get, set

Public Property InsertCommand As IDbCommand

Wartość właściwości

IDbCommand

Element IDbCommand używany podczas Update(DataSet) wstawiania rekordów w źródle danych dla nowych wierszy w zestawie danych.

Przykłady

Poniższy przykład tworzy wystąpienie dziedziczonej OleDbDataAdapter klasy i ustawia SelectCommand właściwości i InsertCommand . Przyjęto założenie, że utworzono OleDbConnection już obiekt.

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

Uwagi

Jeśli Updateta właściwość nie jest ustawiona, a informacje o kluczu DataSetpodstawowym znajdują się w obiekcie , InsertCommand można je wygenerować automatycznie, jeśli ustawisz SelectCommand właściwość dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe polecenia, które nie zostały ustawione, są generowane przez CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w obiekcie DataSet. Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą poleceń CommandBuilders.

Po InsertCommand przypisaniu do wcześniej utworzonego IDbCommandIDbCommand elementu element nie jest klonowany. Obiekt InsertCommand obsługuje odwołanie do wcześniej utworzonego IDbCommand obiektu.

Uwaga / Notatka

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 IDbCommand obiektu.