SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 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.
SQL dizesini UpdateCommand , koleksiyondaki UpdateParameters tüm parametreleri ve belirtilen keys, valuesve oldValues koleksiyonlarındaki değerleri 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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParametreler
- keys
- IDictionary
Güncelleştirme veritabanı işlemini gerçekleştirmek için özelliğiyle UpdateCommand birlikte kullanılacak birincil anahtarlardan biriIDictionary. Sorguyla ilişkilendirilmiş anahtar yoksa veya özelliği parametreli bir SQL sorgusu değilse UpdateCommand , geçirin null.
- values
- IDictionary
Güncelleştirme veritabanı işlemini gerçekleştirmek için özelliğiyle UpdateCommand birlikte kullanılacak değerlerden biriIDictionary. Sorguyla ilişkilendirilmiş parametre yoksa veya parametresiz bir SQL sorgusu değilse UpdateCommand , geçirin null.
- oldValues
- IDictionary
IDictionary Veritabanındaki özgün değerleri temsil eden. Sorguyla ilişkilendirilmiş parametre yoksa veya özelliği parametreli bir SQL sorgusu değilse UpdateCommand , geçirin null.
Döndürülenler
Temel alınan veritabanında güncelleştirilen satır sayısını temsil eden değer.
Özel durumlar
, SqlDataSource temel alınan veri kaynağıyla bağlantı kuramıyor.
-veya-
ConflictDetection özelliği değerine ayarlanır CompareAllValues ve parametre oldValues geçirilmemektedir.
Geçerli kullanıcının veritabanına erişim kazanmak için doğru izinleri yok.
CanUpdate özelliği false.
Açıklamalar
sınıfı, SqlDataSourceView veritabanındaki 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 UpdateParameters içerdiği tüm değerlerle birleştirilir.
ConflictDetection özelliği olarak CompareAllValuesayarlanırsa, koleksiyonda oldValues yer alan değerler ve ile OldValuesParameterFormatString biçimlendirilir ve 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.
İşlemi gerçekleştirmek için, SqlDataSourceView metni ve ilişkili UpdateParameters özellikleri kullanarak UpdateCommand bir DbCommand nesne oluşturur ve sonra nesneyi temel alınan veritabanında yürütürDbCommand. İş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 ve hata kodlarını inceleyebilir ve işlem sonrası işlemleri gerçekleştirebilirsiniz.
