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

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Nesnenin temsil ettiği DataSourceView veri 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

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

values

IDictionary

IDictionary Veri öğelerini ve bunların yeni değerlerini temsil eden bir ad/değer çifti.

oldValues

IDictionary

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

Döndürülenler

Int32

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

Özel durumlar

NotSupportedException

İşlem ExecuteUpdate(IDictionary, IDictionary, IDictionary) tarafından DataSourceViewdesteklenmiyor.

Ö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ılabileceğini 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 CanUpdate değerini denetleyerek işlemin bir veri kaynağı denetimi tarafından desteklenip desteklenmediğini ExecuteUpdate belirleyebilir.

parametresi, keys 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 keys parametresi bir 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 bir ad/değer çifti kümesi olan parametresinde values bulunan değerlerle güncelleştirilir.

Uyarı

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 verilerin güncelleştirilmesini destekliyorsa yöntemini geçersiz kılın ExecuteUpdate .

Ayrıca bkz.

• CanUpdate