IDataAdapter.Update(DataSet) Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Belirtilen adlandırılmış bir "Tablo"dan DataTable eklenenDataSet, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini çağırır.

public:
 int Update(System::Data::DataSet ^ dataSet);

public int Update (System.Data.DataSet dataSet);

abstract member Update : System.Data.DataSet -> int

Public Function Update (dataSet As DataSet) As Integer

Parametreler

dataSet

DataSet

DataSet Veri kaynağını güncelleştirmek için kullanılır.

Döndürülenler

Int32

uygulamasından başarıyla güncelleştirilen DataSetsatır sayısı.

Özel durumlar

DBConcurrencyException

INSERT, UPDATE veya DELETE deyimini yürütme girişimi, hiçbir kaydın etkilenmesine neden oldu.

Örnekler

Aşağıdaki örnek, OleDbDataAdapterveri kaynağı için türetilmiş sınıfını Update kullanır. Bu örnekte bir ve DataSetoluşturduğunuz OleDbDataAdapter varsayılır.

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter adapter =
            new OleDbDataAdapter();
        adapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder =
            new OleDbCommandBuilder(adapter);

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

Public Function CreateCommandAndUpdate( _
    ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim adapter As New OleDbDataAdapter()

        adapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

Açıklamalar

Bir uygulama yöntemini çağırdığında Update , IDataAdapter özelliği inceler RowState ve içinde yapılandırılan DataSetdizinlerin sırasına göre her satır için gerekli INSERT, UPDATE veya DELETE deyimlerini yinelemeli olarak yürütür. Örneğin, Update içindeki satırların DataTablesıralanması nedeniyle bir DELETE deyimi, ardından insert deyimi ve başka bir DELETE deyimi yürütebilir.

Bu deyimlerin toplu işlem olarak gerçekleştirilmediğini unutmayın; her satır tek tek güncelleştirilir. Deyim türlerinin GetChanges sırasını denetlemeniz gerekiyorsa bir uygulama yöntemini çağırabilir (örneğin, UPDAT'lerden önceki INSERT'ler). Daha fazla bilgi için bkz . DataAdapters ile Veri Kaynaklarını Güncelleştirme.

INSERT, UPDATE veya DELETE deyimleri belirtilmemişse, Update yöntemi bir özel durum oluşturur. Ancak, bir SqlCommandBuilder .NET Framework veri sağlayıcısının özelliğini ayarlarsanızSelectCommand, tek tablolu güncelleştirmeler için otomatik olarak SQL deyimleri oluşturmak üzere bir veya OleDbCommandBuilder nesnesi oluşturabilirsiniz. Ardından, ayarlamadığınız tüm ek SQL deyimleri 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.

yöntemi, Update güncelleştirme yapmadan önce ilk eşlemede listelenen tablodan satırları alır. , Update özelliğinin değerini UpdatedRowSource kullanarak satırı güncelleştirir. Döndürülen diğer satırlar yoksayılır.

verileri içine DataSetOnRowUpdated geri yüklendikten sonra olay oluşturulur ve kullanıcının uzlaştırılan DataSet satırı ve komutu tarafından döndürülen tüm çıkış parametrelerini incelemesine olanak tanır. Bir satır başarıyla güncelleştirildikten sonra, bu satırda yapılan değişiklikler kabul edilir.

kullanırken Updateyürütme sırası aşağıdaki gibidir:

1. içindeki DataRow değerler parametre değerlerine taşınır.

2. Olay OnRowUpdating oluşturulur.

3. Komut yürütülür.

4. Komut olarak ayarlanırsa FirstReturnedRecord, döndürülen ilk sonuç içine DataRoweklenir.

5. Çıkış parametreleri varsa, bu parametreler içine DataRowkonur.

6. Olay OnRowUpdated oluşturulur.

7. AcceptChanges çağrıldığında.

ile ilişkilendirilmiş her komutun IDataAdapter genellikle kendisiyle ilişkilendirilmiş bir parametre koleksiyonu vardır. Parametreler, bir .NET Framework veri sağlayıcısı Parameter sınıfının SourceColumn ve SourceVersion özellikleri aracılığıyla geçerli satıra eşlenir. SourceColumn geçerli satır için parametre değerlerini almak için başvuruda bulunan bir DataTable sütuna IDataAdapter başvurur.

SourceColumn , herhangi bir tablo eşlemesi uygulanmadan önce eşlenmemiş sütun adını ifade eder. Var olmayan bir sütuna başvuruyorsa SourceColumn , gerçekleştirilen eylem aşağıdaki MissingMappingAction değerlerden birine bağlıdır.

Numaralandırma Değeri	Gerçekleştirilen Eylem
MissingMappingAction.Passthrough	Eşleme yoksa içindeki DataSet kaynak sütun adlarını ve tablo adlarını kullanın.
MissingMappingAction.Ignore	oluşturulur SystemException . Eşlemeler açıkça ayarlandığında, bir giriş parametresi için eksik eşleme genellikle bir hatadan kaynaklanır.
MissingMappingAction.Error	oluşturulur SystemException .

SourceColumn özelliği, çıkış veya giriş/çıkış parametrelerinin değerini ile geri eşlemek DataSetiçin de kullanılır. Var olmayan bir sütuna başvuruyorsa bir özel durum oluşturulur.

SourceVersion bir .NET Framework veri sağlayıcısının Parameter sınıfının özelliği, sütun değerinin Original, Currentveya Proposed sürümünün kullanılıp kullanılmayacağını belirler. Bu özellik genellikle iyimser eşzamanlılık ihlallerini denetlemek için bir UPDATE deyiminin WHERE yan tümcesine özgün değerleri eklemek için kullanılır.

Not

Bir satır güncelleştirilirken hata oluşursa, bir özel durum oluşturulur ve güncelleştirmenin yürütülmesi sonlandırılır. Bir hatayla karşılaşıldığında özel durumlar oluşturmadan güncelleştirme işlemine devam etmek için çağırmadan önce Updateözelliğini olarak true ayarlayınContinueUpdateOnError. DataAdapter olayı içinde RowUpdated hatalara satır başına temelinde de yanıt vekleyebilirsiniz. Olay içinde özel durum oluşturmadan güncelleştirme işlemine RowUpdated devam etmek için özelliğini RowUpdatedEventArgs olarak ContinueayarlayınStatus.