Share via


SqlDataSourceView.ExecuteInsert(IDictionary) Yöntem

Tanım

SQL dizesiniInsertCommand, koleksiyonda belirtilen tüm parametreleri ve belirtilen values koleksiyondaki InsertParameters değerleri kullanarak bir ekleme işlemi gerçekleştirir.

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parametreler

values
IDictionary

Ekleme veritabanı işlemini gerçekleştirmek için özelliğiyle InsertCommand kullanılan değerlerden biriIDictionary. Sorguyla ilişkilendirilmiş parametre yoksa veya özelliği parametreli bir SQL sorgusu değilse InsertCommand geçirin null.

Döndürülenler

Temel alınan veritabanına eklenen satır sayısını temsil eden bir değer.

Özel durumlar

, SqlDataSource temel alınan veri kaynağıyla bağlantı kuramıyor.

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

CanInsert özelliğidirfalse.

Açıklamalar

sınıfı, SqlDataSourceView veritabanına veri eklemek için devralınan ExecuteInsert yöntemi uygular. Sayfa geliştiricileri ve veriye bağlı denetim yazarları yöntemi doğrudan çağırmaz ExecuteInsert ; bunun yerine genel kullanıma sunulan Insert yöntemi kullanın.

Ekleme işlemi gerçekleştirilmeden önce, OnInserting olayı yükseltmek için yöntemi çağrılır Inserting . Parametrelerin değerlerini incelemek ve eklemeden önce herhangi bir ön işleme gerçekleştirmek için bu olayı işleyebilirsiniz.

Ekleme işlemi gerçekleştirmek için nesne, SqlDataSourceView metni ve ilişkili InsertParameters özellikleri kullanarak InsertCommand bir DbCommand nesne oluşturur ve sonra nesneyi temel alınan veritabanında yürütürDbCommand. Ekleme tamamlandıktan sonra, OnInserted olayı yükseltmek için yöntemi çağrılır Inserted . 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.