IDbDataAdapter.InsertCommand Vlastnost

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.dll

Získá nebo nastaví příkaz SQL použitý k vložení nových záznamů do zdroje dat.

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

Hodnota vlastnosti

IDbCommand

IDbCommand Slouží Update(DataSet) k vložení záznamů do zdroje dat pro nové řádky v sadě dat.

Příklady

Následující příklad vytvoří instanci zděděné OleDbDataAdapter třídy a nastaví SelectCommand a InsertCommand vlastnosti. Předpokládá se, že jste už vytvořili OleDbConnection objekt.

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

Poznámky

Pokud Updatetato vlastnost není nastavena a informace o primárním klíči jsou přítomny v nástroji DataSet, InsertCommand lze vygenerovat automaticky, pokud nastavíte SelectCommand vlastnost zprostředkovatele dat rozhraní .NET Framework. Potom se všechny další příkazy, které nenastavíte, vygenerují CommandBuilder. Tato logika generování vyžaduje, aby informace o klíčovém sloupci byly přítomny v objektu DataSet. Další informace naleznete v tématu Generování příkazů pomocí CommandBuilders.

Při InsertCommand přiřazení k dříve vytvořenému IDbCommandsouboru IDbCommand se nenaklonuje. Udržuje InsertCommand odkaz na dříve vytvořený IDbCommand objekt.

Note

Pokud provádění tohoto příkazu vrátí řádky, mohou být tyto řádky přidány do DataSet závislosti na tom, jak nastavíte UpdatedRowSource vlastnost objektu IDbCommand .