IDbDataAdapter.InsertCommand Özellik

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.dll

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

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

Özellik Değeri

IDbCommand

veri IDbCommand kümesindeki yeni satırlar için veri kaynağına kayıt eklemek için kullanılır Update(DataSet) .

Örnekler

Aşağıdaki örnek devralınan OleDbDataAdapter sınıfın bir örneğini oluşturur ve ve SelectCommand özelliklerini ayarlarInsertCommand. 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 mevcutsa, .NET Framework veri sağlayıcısının SelectCommand özelliğini ayarlarsanız otomatik olarak oluşturulabilir. Ardından, ayarlamadığınız tüm ek komutlar CommandBuilder tarafından oluş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ş InsertCommandIDbCommand bir öğesine atandığındaIDbCommand, kopyalanmaz. , InsertCommand daha önce oluşturulan IDbCommand nesneye bir başvuru tutar.

Note

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