Aracılığıyla paylaş


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

Tanım

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 -> 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 UpdateCommand kullanılacak birincil anahtarlardan biri. 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 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 bir. 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 bir 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ğidirfalse.

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ı yöntemi doğrudan çağırmaz ExecuteUpdate ; bunun yerine genel kullanıma sunulan Update yöntemi kullanın.

ve values koleksiyonlarında keys bulunan 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 ö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.

Şunlara uygulanır

Ayrıca bkz.