Aracılığıyla paylaş

.NET Framework uygulamalarında TableAdapters oluşturma ve yapılandırma

Uyarı

Sınıf DataSet ve ilgili sınıflar, uygulamaların veritabanıyla bağlantısı kesilirken uygulamaların bellekteki verilerle çalışmasını sağlayan 2000'lerin başlarındaki eski .NET Framework teknolojileridir. Teknolojiler özellikle kullanıcıların verileri değiştirmesine ve değişiklikleri veritabanında kalıcı hale getirebilmesine olanak tanıyan uygulamalar için kullanışlıdır. Veri kümeleri başarısı kanıtlanmış bir teknoloji olsa da, yeni .NET uygulamaları için önerilen yaklaşım Entity Framework Core kullanmaktır. Entity Framework, tablosal verilerle nesne modelleri olarak çalışmak için daha doğal bir yol sağlar ve daha basit bir programlama arabirimine sahiptir.

TableAdapters , uygulamanızla veritabanı arasında iletişimi etkinleştirir. Veritabanına bağlanır, sorgular veya saklı yordamlar çalıştırır ve yeni bir veri tablosu döndürür veya mevcut DataTable bir sınıf örneğini döndürülen verilerle doldurur. TableAdapters, güncelleştirilmiş verileri uygulamanızdan veritabanına da gönderebilir.

TableAdapters, aşağıdaki eylemlerden birini gerçekleştirdiğinizde oluşturulur:

  • Veritabanı nesnelerini Sunucu Gezgini'ndenVeri Kümesi Tasarımcısı'na sürükleyin.

  • TableAdapter Nesneyi Araç Kutusu'ndanVeri Kümesi Tasarımcısı yüzeyindeki boş bir bölgeye sürükleyin ve ardından veri kaynağını yapılandırın.

  • Veri Kaynağı Yapılandırma Sihirbazı'nı çalıştırın ve Veritabanı veya Web Hizmeti veri kaynağı türünü seçin:

    Visual Studio'daki Veri Kaynağı Yapılandırma Sihirbazı'nda veri kaynağı türünün nasıl seçildiğini gösteren ekran görüntüsü.

TableAdapters'a giriş için bkz. TableAdapters kullanarak veri kümelerini doldurma.

Önkoşullar

Bu makaledeki yordamları tamamlamak için aşağıdaki önkoşulların karşılanması gerekir:

Uyarı

Bu makaledeki yönergeler, Visual Studio'da kullanılabilen etkileşimli geliştirme deneyiminin (IDE) en son sürümünü gösterir. Bilgisayarınız bazı kullanıcı arabirimi öğeleri için farklı adlar veya konumlar gösterebilir. Visual Studio'nun farklı bir sürümünü veya farklı ortam ayarlarını kullanıyor olabilirsiniz. Daha fazla bilgi için bkz. IDEkişiselleştirme.

TableAdapter Yapılandırma Sihirbazı'na erişme

TableAdapter Yapılandırma Sihirbazı'nı kullanarak yeni TableAdapters oluşturabilir veya mevcut örnekleri düzenleyebilir ve ilişkili veri tablolarını yapılandırabilirsiniz.

  • Mevcut bir TableAdapter'ı sihirbazla yapılandırmak için , Veri Kümesi Tasarımcısı'nda TableAdapter örneğine sağ tıklayın ve Yapılandır'ı seçin:

    Visual Studio'da Tablo Bağdaştırıcısı Yapılandırma Sihirbazı'na nasıl erişildiğini gösteren ekran görüntüsü.

  • Sihirbazla yeni bir TableAdapter oluşturmak için, nesneyi Araç Kutusu'ndanVeri Kümesi Tasarımcısı yüzeyindeki boş bir bölgeye sürükleyinTableAdapter.

Sihirbazı kullanma

TableAdapter yapılandırması için TableAdapter Yapılandırma Sihirbazı aşağıdaki görevlerde size yol gösterir:

  1. TableAdapter için gerekli ayarları yapılandırın.

    • TableAdapter bağlantısı için veri kaynağı türünü belirtin.

    • SQL deyimleri veya saklı yordamlar olmak üzere veritabanıyla iletişim için kullanılacak komutları belirleyin. TableAdapter zaten bir veri kaynağıyla ilişkiliyse, sihirbazda bu seçeneği görmezsiniz.

  2. Gerektiğinde saklı yordamlar oluşturun.

    Veritabanı için doğru izinlere sahipseniz, temel veritabanında yeni bir saklı yordam oluşturun. Gerekli izinlere sahip değilseniz bu seçenek sihirbazda kullanılamaz.

  3. Mevcut saklı yordamları gerektiğinde çalıştırın.

    TableAdapter'ın SELECT, INSERT, UPDATE ve DELETE komutları için yordamlar kullanılabilir. Örneğin, UPDATE komutuna atanan saklı yordam, TableAdapter.Update() metodunu çağırdığınızda çalışır.

  4. Seçili saklı yordamdaki parametreleri veri tablosundaki ilgili sütunlara eşleyin. Örneğin, saklı yordamınız veri tablosundaki CompanyName sütununa aktardığı @CompanyName adlı bir parametre kabul ediyorsa, @CompanyName parametresinin Kaynak Sütunu'nu CompanyName olarak ayarlayın.

    Uyarı

    SELECT komutu için saklı yordam varsayılan olarak TableAdapter Fill yöntemini çağırdığınızda çalışır. Sihirbazın sonraki sayfasında Fill() yöntemi için bir ad belirtirsiniz . Varsayılan yöntemi kullandığınızda, SELECT komutu için saklı yordamı çalıştırmaya yönelik tipik koddur TableAdapter.Fill(<TableName>). Veri tablosunun adıyla <TableName> bölümünü değiştirirsiniz.

    Varsayılan yöntem adını Fill'den değiştirirseniz, yordamın kodunu güncelleştirmeniz gerekir. değerini yeni yöntem adıyla değiştirin Fill ve TableAdapter'ın gerçek adını kullanın. Örneğin, CustomersTableAdapter adlı bir TableAdapter ve CustomersTable adlı bir veri tablosu için, Fill yöntem adını AddData olarak değiştirirseniz, kodu CustomersTableAdapter.AddData(CustomersTable) olarak güncelleyin.

    • Güncelleştirmeleri doğrudan veritabanına göndermek için Yöntemler oluştur seçeneğinin etkinleştirilip etkinleştirilmeyeceğini seçin. Bu seçenek etkinleştirildiğinde, GenerateDBDirectMethods özelliğinin true olarak ayarlanmasına eşdeğerdir. Özgün SQL deyimi yeterli bilgi sağlamadığında veya sorgu güncelleştirilebilir bir sorgu olmadığında seçeneği kullanılamaz. Örneğin, JOIN sorguları ve diğer sorgular tek bir (skaler) değer döndürdiğinde.

  5. Gelişmiş Seçenekler için tercihlerinizi yapılandırın.

    • SQL deyimleri oluştur sayfasında tanımlanan SELECT komutunu temel alarak INSERT, UPDATE ve DELETE komutları oluşturun.

    • İyimser eşzamanlılık kullanın.

    • INSERT ve UPDATE komutları çalıştırıldıktan sonra veri tablosunu yenileyin.

TableAdapter.Fill() yöntemini yapılandırma

Bazı senaryolarda TableAdapter'ın veri tablosunun şemasını değiştirmek isteyebilirsiniz. Eylemi tamamlamak için TableAdapter'ın birincil Fill yöntemini değiştirirsiniz. TableAdapters, ilişkili veri tablosunun şemasını tanımlayan birincil Fill bir yöntemle oluşturulur. Birincil Fill yöntem, TableAdapter'ı ilk kez yapılandırırken girdiğiniz sorguyu veya saklı yordamı temel alır. Veri Kümesi Tasarımcısı'ndaki veri tablosunun altındaki ilk (en üst) yöntemdir.

TableAdapter'ın birden çok sorguyla nasıl kullanılacağını gösteren diyagram.

TableAdapter'ın ana Fill yönteminde yaptığınız tüm değişiklikler ilişkili veri tablosunun şemasına yansıtılır. Örneğin, main Fill yöntemindeki sorgudan bir sütunun kaldırılması, sütunu ilişkili veri tablosundan da kaldırır. Ayrıca, sütunu main Fill yönteminden kaldırmak, sütunu bu TableAdapter için ek sorgulardan kaldırır.

TableAdapter Sorgu Yapılandırma Sihirbazı'nı kullanarak TableAdapter için ek sorgular oluşturabilir ve düzenleyebilirsiniz. Skaler değer döndürmedikleri sürece bu ek sorguların tablo şemasına uyması gerekir. Her bir ek sorgu, belirttiğiniz bir isme sahiptir.

Aşağıdaki örnekte adlı FillByCityek bir sorgunun nasıl çağrılacakları gösterilmektedir:

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

Sihirbazla sorgu oluşturma

Aşağıdaki adımları izleyerek TableAdapter Sorgu Yapılandırma Sihirbazı ile yeni bir sorgu oluşturabilirsiniz:

  1. veri kümenizi Veri Kümesi Tasarımcısıaçın.

  2. Aşağıdaki eylemlerden biriyle yeni bir sorgu oluşturun:

    • Veri Kümesi Tasarımcısı'nda TableAdapter'a sağ tıklayın ve Sorgu Ekle'yi seçin.
    • Query Nesneyi Araç Kutusu'nunDataSet sekmesinden Veri Kümesi Tasarımcısı yüzeyindeki öğesine DataTable sürükleyin.
    • Query Nesneyi Araç Kutusu'ndanVeri Kümesi Tasarımcısı yüzeyindeki boş bir bölgeye sürükleyin; bu, ilişkili DataTableolmayan bir TableAdapter oluşturur.

    Bu sorgular yalnızca tek (skaler) değerler döndürebilir veya veritabanında UPDATE, INSERT veya DELETE komutlarını çalıştırabilir.

  3. Veri Bağlantınızı Seçin ekranında var olan bir bağlantıyı seçin veya sorgu için yeni bir bağlantı oluşturun.

    Uyarı

    Bu ekran yalnızca tasarımcı kullanılacak bağlantıyı belirleyemiyorsa veya kullanılabilir bağlantı olmadığında görünür.

  4. Komut Türü Seçin ekranında, veritabanından veri getiren aşağıdaki yöntemlerden birini seçerek komutu yapılandırın:

    • SQL deyimlerini kullanma: Veritabanınızdan verileri seçmek için bir SQL deyimi girersiniz.

    • Yeni saklı yordam oluşturma: Sihirbaz, belirtilen SELECT komutunu temel alan yeni bir saklı yordam (veritabanında) oluşturur.

    • Mevcut saklı yordamları kullan: Sorguyu çalıştırdığınızda var olan bir saklı yordamı yürütürsiniz.

Sihirbazla sorgu yapılandırma

TableAdapter Sorgu Yapılandırma Sihirbazı ile var olan bir TableAdapter sorgusunu düzenlemek için sorguya sağ tıklayın ve Yapılandır'ı seçin. Sağ tıklama eylemi, seçtiğiniz sorgu türüne bağlı olarak farklı bir sonuç üretir:

  • TableAdapter'ın ana sorgusu için hem TableAdapter hem DataTable de şema yeniden yapılandırılır.

  • TableAdapter'da ek bir sorguda, yalnızca seçili sorgu yeniden yapılandırılır.

TableAdapter Yapılandırma Sihirbazı TableAdapter tanımını yeniden yapılandırırken, TableAdapter Sorgu Yapılandırma Sihirbazı yalnızca seçili sorguyu yeniden yapılandırır.

TableAdapter'a genel sorgu ekleme

Genel sorgular, tek bir (skaler) değer döndüren veya değer içermeyen SQL sorgularıdır. Genel işlevler genellikle eklemeler, güncelleştirmeler ve silmeler gibi veritabanı işlemlerini gerçekleştirir. Ayrıca bir tablodaki müşteri sayısı veya belirli bir siparişteki tüm öğelerin toplam ücretleri gibi bilgileri de toplar.

  1. Nesneyi Araç Kutusu'nunDataSet sekmesinden Veri Kümesi Tasarımcısı yüzeyindeki boş bir bölgeye sürükleyerek Query genel sorgu ekleyin.

  2. gibi SELECT COUNT(*) AS CustomerCount FROM Customersbelirli bir görevi gerçekleştiren bir sorgu girin.

    Uyarı

    Nesneyi Query doğrudan Veri Kümesi Tasarımcısı yüzeyine sürüklemek, yalnızca skaler (tek) değer döndüren bir yöntem oluşturur. Seçtiğiniz sorgu veya saklı yordam tek bir değerden daha fazlasını döndürebileceğinden, sihirbaz tarafından oluşturulan yöntem yalnızca tek bir değer döndürür. Örneğin, sorgu döndürülen verilerin ilk satırının ilk sütununu döndürebilir.

İlgili içerik

  • Last updated on