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

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.dll

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

Int32

Temel alınan veritabanında güncelleştirilen satır sayısını temsil eden bir değer.

Özel durumlar

InvalidOperationException

, 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.

HttpException

Geçerli kullanıcının veritabanına erişim kazanmak için doğru izinleri yok.

NotSupportedException

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.

Ayrıca bkz.

• Update(IDictionary, IDictionary, IDictionary)
• UpdateCommand
• UpdateParameters