IDbDataAdapter.InsertCommand Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.