IDbDataAdapter.InsertCommand Özellik

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.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 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 DataSetbulunursa, InsertCommand bir .NET Framework veri sağlayıcısının SelectCommand özelliğini ayarlarsanız otomatik olarak oluşturulabilir. Ardından, ayarlamadığınız 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.

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

Not

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