OleDbDataAdapter.InsertCommand Özellik

Tanım

Veri kaynağına yeni kayıtlar eklemek için kullanılan bir SQL deyimini veya saklı yordamı alır veya ayarlar.

public:
 property System::Data::OleDb::OleDbCommand ^ InsertCommand { System::Data::OleDb::OleDbCommand ^ get(); void set(System::Data::OleDb::OleDbCommand ^ value); };
public System.Data.OleDb.OleDbCommand? InsertCommand { get; set; }
[System.Data.DataSysDescription("DbDataAdapter_InsertCommand")]
public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }
public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set
[<System.Data.DataSysDescription("DbDataAdapter_InsertCommand")>]
member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set
Public Property InsertCommand As OleDbCommand

Özellik Değeri

veri OleDbCommand kaynağına içindeki yeni satırlara DataSetkarşılık gelen kayıtları eklemek için kullanılırUpdate(DataSet).

Öznitelikler

Örnekler

Aşağıdaki örnek bir OleDbDataAdapter oluşturur ve ve InsertCommand özelliklerini ayarlarSelectCommand. Zaten bir OleDbConnection nesne oluşturduğunuz varsayılır.

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

Açıklamalar

sırasındaUpdate, bu özellik ayarlanmazsa ve birincil anahtar bilgileri içinde DataSetInsertCommand bulunursa, özelliğini ayarlar SelectCommand ve kullanırsanız OleDbCommandBuilderotomatik olarak oluşturulabilir. Ardından, ayarlamadığınız ek komutlar tarafından OleDbCommandBuilderoluşturulur. Bu oluşturma mantığı, anahtar sütun bilgilerinin içinde DataSetmevcut olmasını gerektirir. Daha fazla bilgi için bkz. CommandBuilders ile Komut Oluşturma.

önceden oluşturulmuş OleDbCommandOleDbCommand bir öğesine atandığında InsertCommand kopyalanmaz. , InsertCommand daha önce oluşturulan OleDbCommand nesneye bir başvuru tutar.

Not

Bu komutun yürütülmesi satırları döndürürse, nesnenin özelliğini OleDbCommand nasıl ayarladığınıza DataSetUpdatedRowSource bağlı olarak bu satırlar öğesine eklenebilir.

Şunlara uygulanır

Ayrıca bkz.