IDbDataAdapter.InsertCommand Vlastnost

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Získá nebo nastaví příkaz SQL sloužící 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

Slouží IDbCommand k Update(DataSet) 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 vlastnosti a InsertCommand . Předpokládá se, že jste objekt už vytvořili OleDbConnection .

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 Updateběhem příkazu není tato vlastnost nastavena a informace o primárním klíči jsou obsaženy v objektu DataSet, InsertCommand lze automaticky vygenerovat, pokud nastavíte SelectCommand vlastnost zprostředkovatele dat rozhraní .NET Framework. Potom se všechny další příkazy, které nenastavíte, vygeneruje CommandBuilder. Tato logika generování vyžaduje, aby informace o klíčovém sloupci DataSetbyly v . Další informace najdete v tématu Generování příkazů pomocí CommandBuilders.

Při InsertCommand přiřazení k dříve vytvořenému IDbCommandobjektu IDbCommand se objekt neklonuje. Objekt InsertCommand udržuje odkaz na dříve vytvořený IDbCommand objekt.

Poznámka

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