DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Yöntem

Tanım

Nesnenin temsil olduğu veri DataSourceView listesinde bir güncelleştirme işlemi gerçekleştirir.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parametreler

keys
IDictionary

IDictionary Güncelleştirme işlemi tarafından güncelleştirilecek nesne veya satır anahtarlarından biri.

values
IDictionary

IDictionary Veri öğelerini ve yeni değerlerini temsil eden ad/değer çiftlerinden biri.

oldValues
IDictionary

IDictionary Veri öğelerini ve özgün değerlerini temsil eden ad/değer çiftlerinden biri.

Döndürülenler

Temel alınan veri depolama alanında güncelleştirilen öğelerin sayısı.

Özel durumlar

Örnekler

Aşağıdaki kod örneği, sınıfını genişleten bir sınıfın DataSourceView özelliğini ve ExecuteUpdate yöntemini nasıl geçersiz kıldığını CanUpdate gösterir. Bu kod örneği, sınıfı için DataSourceView sağlanan daha büyük bir örneğin parçasıdır.

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}
   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Açıklamalar

Veriye bağlı denetimler, nesnesini almak DataSourceView için yöntemini kullanarak DataSourceControl.GetView ve özelliğin değerini CanUpdate denetleyerek işlemin bir veri kaynağı denetimi tarafından desteklenip desteklenmediğini ExecuteUpdate belirleyebilir.

keys parametresi, güncelleştirilecek verilerin nesne veya satır anahtarlarını temsil eder. Denetim gibi SqlDataSource ilişkisel verileri temsil eden veri kaynakları için parametresi, keys veritabanı birincil anahtarlarından oluşan bir koleksiyondur. Diğer senaryolarda parametresi bir keys ad/değer çiftleri koleksiyonudur ve bir veri listesini filtrelemek için kullanılır. Ad/değer çiftiyle eşleşen tüm veriler, mevcut alanlar veya sütunlar için yeni değerleri temsil eden ad/değer çiftleri kümesi olan parametresinde values bulunan değerlerle güncelleştirilir.

Not

Sınıfın DataSourceView varsayılan uygulaması bir NotSupportedException özel durum oluşturmaktır. sınıfını DataSourceView genişletirseniz, sınıfınız temel alınan veri depolamadaki verileri güncelleştirmeyi destekliyorsa yöntemini geçersiz kılın ExecuteUpdate .

Şunlara uygulanır

Ayrıca bkz.