ObjectDataSourceView.ExecuteUpdate Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
özelliği tarafından UpdateMethod tanımlanan yöntemini çağırarak 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 birlikte kullanılacak birincil anahtarlardan biri. yöntemiyle ilişkilendirilmiş anahtar yoksa, geçirin null.
- values
- IDictionary
IDictionary Güncelleştirme veritabanı 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.
oldValues veya boş ve nullConflictDetection 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ı doğrudan yöntemini ç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 içerdiği UpdateParameters 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, ObjectDataSourceView özelliği ve koleksiyondaki 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. .