IDbDataAdapter.InsertCommand Egenskap

Definition

Hämtar eller anger en SQL-instruktion som används för att infoga nya poster i datakällan.

public:
 property System::Data::IDbCommand ^ InsertCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };
public System.Data.IDbCommand? InsertCommand { get; set; }
public System.Data.IDbCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.IDbCommand with get, set
Public Property InsertCommand As IDbCommand

Egenskapsvärde

Används IDbCommand under Update(DataSet) för att infoga poster i datakällan för nya rader i datauppsättningen.

Exempel

I följande exempel skapas en instans av den ärvda OleDbDataAdapter klassen och egenskaperna och SelectCommand angesInsertCommand. Det förutsätter att du redan har skapat ett 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

Kommentarer

Under Update kan DataSet genereras automatiskt om du anger egenskapen InsertCommand för en .NET Framework-dataprovider om den finns i SelectCommand. Sedan genereras eventuella ytterligare kommandon som du inte anger av CommandBuilder. Den här generationslogik kräver att information om nyckelkolumner DataSetfinns i . Mer information finns i Generera kommandon med CommandBuilders.

När InsertCommand har tilldelats till en tidigare skapad IDbCommandIDbCommand klonas inte . Underhåller InsertCommand en referens till det tidigare skapade IDbCommand objektet.

Note

Om körningen av det här kommandot returnerar rader kan dessa rader läggas till DataSet beroende på hur du anger UpdatedRowSource objektets IDbCommand egenskap.

Gäller för