IDbDataAdapter.InsertCommand Tulajdonság

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

IDbDataAdapter.cs

Lekéri vagy beállít egy SQL-utasítást, amellyel új rekordokat szúrhat be az adatforrásba.

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

Tulajdonság értéke

IDbCommand

Ez IDbCommand az Update(DataSet) adatkészlet új sorainak rekordjainak beszúrása az adatforrásba.

Példák

Az alábbi példa létrehozza az örökölt osztály egy példányátOleDbDataAdapter, és beállítja a SelectCommand tulajdonságokat.InsertCommand Feltételezi, hogy már létrehozott egy OleDbConnection objektumot.

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

Megjegyzések

A Update során, ha ez a tulajdonság nincs beállítva, és az elsődleges kulcs információi megtalálhatók a DataSet, a InsertCommand automatikusan létrejön, ha beállítja egy .NET-keretrendszer adatszolgáltatójának SelectCommand tulajdonságát. Ezután a nem beállított további parancsokat a CommandBuilder hozza létre. Ez a generációs logika megköveteli, hogy a kulcsoszlopok adatai szerepeljenek a DataSet. További információ: Parancsok generálása CommandBuilders használatával.

Ha InsertCommand egy korábban létrehozotthoz IDbCommandvan rendelve, a IDbCommand rendszer nem klónozza. A InsertCommand korábban létrehozott IDbCommand objektumra mutató hivatkozást tart fenn.

Note

Ha a parancs végrehajtása sorokat ad vissza, ezek a sorok hozzáadhatók az DataSet objektum tulajdonságának UpdatedRowSource beállításától IDbCommand függően.