ObjectDataSourceView.ExecuteUpdate Yöntem

Tanım

özelliği tarafından tanımlanan yöntemini çağırarak UpdateMethod ve , valuesveya oldValues koleksiyonlarında keyssağlanan parametreleri kullanarak bir güncelleştirme işlemi gerçekleştirir.

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

Parametreler

keys
IDictionary

IDictionary Güncelleştirme veritabanı işlemini gerçekleştirmek için özelliğiyle UpdateMethod kullanılacak birincil anahtarlardan biri. yöntemiyle ilişkilendirilmiş anahtar yoksa geçirin null.

values
IDictionary

IDictionary Veritabanı güncelleştirme işlemini gerçekleştirmek için ile UpdateMethod birlikte kullanılacak değerlerden biri. yöntemiyle ilişkilendirilmiş parametre yoksa geçirin null.

oldValues
IDictionary

IDictionary Temel alınan veri deposundaki özgün değerleri temsil eden bir. Sorguyla ilişkilendirilmiş parametre yoksa geçirin null.

Döndürülenler

Güncelleştirilen satır sayısı; veya -1, sayı bilinmiyorsa. Daha fazla bilgi için bkz. Update().

Özel durumlar

CanInsert özelliği döndürürfalse.

oldValuesveya boş ConflictDetection ve null olarak CompareAllValuesayarlanır.

Açıklamalar

sınıfı, ObjectDataSourceView bir iş nesnesi kullanarak verileri güncelleştirmek için devralınan ExecuteUpdate yöntemi uygular. Sayfa geliştiricileri ve veriye bağlı denetim yazarları yöntemi doğrudan çağırmaz ExecuteUpdate ; bunun yerine genel kullanıma sunulan Update yöntemi kullanın.

ve values koleksiyonlarında keys yer alan değerler değerlendirilir ve koleksiyonun UpdateParameters içerdiği tüm değerlerle birleştirilir. ConflictDetection özelliği değerine ayarlanırsaCompareAllValues, koleksiyonda oldValues yer alan değerler özelliğiyle OldValuesParameterFormatString biçimlendirilir ve ayrıca birleştirilir.

Güncelleştirme işlemi gerçekleştirilmeden önce, OnUpdating olayı yükseltmek için yöntemi çağrılır Updating . Parametrelerin değerlerini incelemek ve güncelleştirmeden önce herhangi bir ön işleme gerçekleştirmek için bu olayı işleyebilirsiniz. Bir güncelleştirme işlemi gerçekleştirmek için, özelliği ve koleksiyondaki ObjectDataSourceView ilişkili parametreler keys tarafından UpdateMethod tanımlanan yöntemi çağırmak için yansımayı kullanır ve ardından yürütür. İşlem tamamlandıktan sonra, OnUpdated olayı yükseltmek için yöntemi çağrılır Updated . Bu olayı işleyerek dönüş değerlerini, hata kodlarını inceleyebilir ve işlem sonrası işlemleri gerçekleştirebilirsiniz.

Güncelleştirilen satır sayısını döndürme hakkında daha fazla bilgi için bkz Update. .

Şunlara uygulanır

Ayrıca bkz.