IDbDataAdapter.UpdateCommand Özellik

Tanım

Veri kaynağındaki kayıtları güncelleştirmek için kullanılan bir SQL deyimini alır veya ayarlar.

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

Özellik Değeri

Veri IDbCommand kümesindeki değiştirilmiş satırlar için veri kaynağındaki kayıtları güncelleştirmek 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 UpdateCommand özelliklerini ayarlarSelectCommand. Zaten bir OleDbConnection nesne oluşturduğunuz varsayılır.

private static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT * FROM dbo.Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    dataAdapter.SelectCommand = command;

    // Create the UpdateCommand.
    command = new OleDbCommand(
        "UPDATE dbo.Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    parameter = command.Parameters.Add(
        "oldCustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.UpdateCommand = command;

    return dataAdapter;
}
Private Function CreateCustomerAdapter( _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim dataAdapter As New OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT * FROM dbo.Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    dataAdapter.SelectCommand = command

    ' Create the UpdateCommand.
    command = New OleDbCommand("UPDATE dbo.Customers " & _
        "SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    parameter = command.Parameters.Add( _
        "oldCustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.UpdateCommand = command

    Return dataAdapter
End Function

Açıklamalar

sırasındaUpdate, bu özellik ayarlanmazsa ve birincil anahtar bilgileri içinde DataSetbulunursa, UpdateCommand 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 UpdateCommand kopyalanmaz. , UpdateCommand daha önce oluşturulan IDbCommand nesneye bir başvuru tutar.

Not

Bu komutun yürütülmesi satırları döndürürse, bu satırlar öğesine DataSeteklenir.

Şunlara uygulanır