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

Tanım

UpdateCommandSQL dizesini, koleksiyondaki tüm parametreleri UpdateParameters ve belirtilen keys , values , ve oldValues koleksiyonlardaki değerleri kullanarak bir güncelleştirme işlemi gerçekleştirir.Performs an update operation using the UpdateCommand SQL string, any parameters that are in the UpdateParameters collection, and the values that are in the specified keys, values, and oldValues collections.

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 UpdateCommand Veritabanını güncelleştirme işlemini gerçekleştirmek için özelliği ile birlikte kullanılacak birincil anahtarlar.An IDictionary of primary keys to use with the UpdateCommand property to perform the update database operation. Sorguyla ilişkili bir anahtar yoksa veya UpdateCommand özellik parametreli BIR SQL sorgusu değilse, pass null .If there are no keys associated with the query or if the UpdateCommand property is not a parameterized SQL query, pass null.

values
IDictionary

IDictionary UpdateCommand Veritabanını güncelleştirme işlemini gerçekleştirmek için özelliği ile birlikte kullanılacak değerler.An IDictionary of values to use with the UpdateCommand property to perform the update database operation. Sorguyla ilişkili bir parametre yoksa veya UpdateCommand parametreli BIR SQL sorgusu değilse, pass null .If there are no parameters associated with the query or if the UpdateCommand is not a parameterized SQL query, pass null.

oldValues
IDictionary

IDictionaryVeritabanındaki özgün değerleri temsil eden bir.An IDictionary that represents the original values in the database. Sorguyla ilişkili bir parametre yoksa veya UpdateCommand özellik parametreli BIR SQL sorgusu değilse, pass null .If there are no parameters associated with the query or if the UpdateCommand property is not a parameterized SQL query, pass null.

Döndürülenler

Int32

Temel veritabanında güncellenen satır sayısını temsil eden bir değer.A value that represents the number of rows updated in the underlying database.

Özel durumlar

SqlDataSourceTemel alınan veri kaynağıyla bağlantı kuramıyor.The SqlDataSource cannot establish a connection with the underlying data source.

-veya--or- ConflictDetectionÖzelliği CompareAllValues değerine ayarlanır ve hiçbir oldValues parametre geçirilmemelidir.The ConflictDetection property is set to the CompareAllValues value and no oldValues parameters are passed.

Geçerli kullanıcı veritabanına erişim kazanmak için doğru izinlere sahip değil.The current user does not have the correct permissions to gain access to the database.

CanUpdateÖzelliği false .The CanUpdate property is false.

Açıklamalar

SqlDataSourceViewSınıfı, ExecuteUpdate bir veritabanındaki verileri güncelleştirmek için devralınmış yöntemi uygular.The SqlDataSourceView class implements the inherited ExecuteUpdate method to update data in a database. Sayfa geliştiricileri ve veri bağlantılı denetim yazarları ExecuteUpdate yöntemi doğrudan çağırmaz; bunun yerine, genel kullanıma sunulan Update yöntemi kullanın.Page developers and data-bound control authors do not call the ExecuteUpdate method directly; instead, use the publicly exposed Update method.

Ve koleksiyonlarında bulunan değerler, keys values koleksiyon tarafından içerilen tüm değerlerle değerlendirilir ve birleştirilir UpdateParameters .The values contained in the keys and values collections are evaluated and merged with any values contained by the UpdateParameters collection. ConflictDetectionÖzelliği olarak ayarlandıysa CompareAllValues , koleksiyonda yer alan değerler oldValues ile biçimlendirilir OldValuesParameterFormatString ve ayrıca birleştirilir.If the ConflictDetection property is set to CompareAllValues, the values contained in the oldValues collection are formatted with the OldValuesParameterFormatString and also merged.

Güncelleştirme işlemi gerçekleştirilmeden önce OnUpdating olayı yükseltmek için yöntemi çağırılır Updating .Before the update operation is performed, the OnUpdating method is called to raise the Updating event. Parametrelerin değerlerini incelemek ve bir güncelleştirmeden önce ön işleme gerçekleştirmek için bu olayı işleyebilirsiniz.You can handle this event to examine the values of the parameters and perform any preprocessing before an update.

İşlemi gerçekleştirmek için, SqlDataSourceView DbCommand UpdateCommand metni ve ilişkili tüm özellikleri kullanarak bir nesne oluşturur UpdateParameters ve sonra DbCommand nesneyi temel alınan veritabanında yürütür.To perform the operation, the SqlDataSourceView builds a DbCommand object using the UpdateCommand text and any associated UpdateParameters properties, and then executes the DbCommand object against the underlying database. İşlem tamamlandıktan sonra, OnUpdated olayı yükseltmek için yöntemi çağırılır Updated .After the operation completes, the OnUpdated method is called to raise the Updated event. Bu olayı, dönüş değerlerini ve hata kodlarını incelemek ve herhangi bir işlemi gerçekleştirmek için işleyebilirsiniz.You can handle this event to examine any return values and error codes and to perform any post-processing.

Şunlara uygulanır

Ayrıca bkz.