SqlDataSourceView.ExecuteInsert(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 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.