.NET Framework uygulamalarında TableAdapter DBDirect yöntemleriyle verileri kaydetme

  • Makale

Not

Veri kümeleri 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ümelerinin çok başarılı bir teknoloji olduğu kanıtlanmış olsa da, yeni .NET uygulamalarının Entity Framework Core kullanmasını öneririz. 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.

Bu öğretici, TableAdapter'ın DBDirect yöntemlerini kullanarak SQL deyimlerini doğrudan veritabanında çalıştırmaya yönelik ayrıntılı yönergeler sağlar. TableAdapter'ın DBDirect yöntemleri, veritabanı güncelleştirmeleriniz üzerinde iyi bir denetim düzeyi sağlar. Uygulamanızın gerektirdiği şekilde tek tek Insert, Updateve Delete yöntemlerini çağırarak (, ve deyimlerinin tümünü tek bir çağrıda gerçekleştiren UPDATEINSERTaşırı yüklenmiş Update yöntemin aksine) belirli SQL deyimlerini ve DELETE saklı yordamları çalıştırmak için bunları kullanabilirsiniz.

Bu öğretici sırasında şunların nasıl yapılacağını öğreneceksiniz:

  • Veri Kaynağı Yapılandırma Sihirbazı ile veri kümesi oluşturun ve yapılandırın.

  • Veri Kaynakları penceresinden öğeleri sürüklerken formda oluşturulacak denetimi seçin. Daha fazla bilgi için bkz . Veri Kaynakları penceresinden sürüklenirken oluşturulacak denetimi ayarlama.

  • Veri Kaynakları penceresindeki öğeleri forma sürükleyerek veriye bağlı bir form oluşturun.

  • Veritabanına doğrudan erişmek ve ekleme, güncelleştirme ve silme işlemleri gerçekleştirmek için yöntemler ekleyin.

Önkoşullar

Bu öğreticideki adımlar .NET Framework Windows Forms Uygulamaları ile çalışır.

Bu öğreticide SQL Server Express LocalDB ve Northwind örnek veritabanı kullanılmaktadır.

  1. SQL Server Express LocalDB'niz yoksa, SQL Server Express indirme sayfasından veya Visual Studio Yükleyicisi aracılığıyla yükleyin. Visual Studio Yükleyicisi, SQL Server Express LocalDB'yi Veri depolama ve işleme iş yükünün bir parçası olarak veya tek bir bileşen olarak yükleyebilirsiniz.

  2. Aşağıdaki adımları izleyerek Northwind örnek veritabanını yükleyin:

    1. Visual Studio'da SQL Server Nesne Gezgini penceresini açın. (SQL Server Nesne Gezgini, Visual Studio Yükleyicisi Veri depolama ve işleme iş yükünün bir parçası olarak yüklenir.) SQL Server düğümünü genişletin. LocalDB örneğinize sağ tıklayın ve Yeni Sorgu'yu seçin.

      Sorgu düzenleyicisi penceresi açılır.

    2. Northwind Transact-SQL betiğini panonuza kopyalayın. Bu T-SQL betiği, Northwind veritabanını sıfırdan oluşturur ve verilerle doldurur.

    3. T-SQL betiğini sorgu düzenleyicisine yapıştırın ve ardından Yürüt düğmesini seçin.

      Kısa bir süre sonra sorgunun çalışması tamamlanır ve Northwind veritabanı oluşturulur.

Windows Forms uygulaması oluşturma

İlk adım bir Windows Forms Uygulaması (.NET Framework) oluşturmaktır. C# veya Visual Basic kullanarak Windows Forms Uygulaması proje türünü kullanarak proje oluşturun.

Not

Bu öğreticinin kodu C# ve Visual Basic'te kullanılabilir. Bu sayfadaki kod dilini C# ve Visual Basic arasında değiştirmek için, sağ taraftaki sayfanın üst kısmındaki kod dili değiştiricisini kullanın.

Veritabanınızdan veri kaynağı oluşturma

Bu adım, Northwind örnek veritabanındaki tabloyu temel alan Region bir veri kaynağı oluşturmak için Veri Kaynağı Yapılandırma Sihirbazı'nı kullanır. Bağlantıyı oluşturmak için Northwind örnek veritabanına erişiminiz olmalıdır. Northwind örnek veritabanını ayarlama hakkında bilgi için bkz . Nasıl yapılır: Örnek veritabanlarını yükleme.

Veri kaynağı oluşturmak için

  1. Veri menüsünde Veri Kaynaklarını Göster'i seçin.

    Veri Kaynakları penceresi açılır.

  2. Veri Kaynağı Yapılandırma Sihirbazı'nı başlatmak için Veri Kaynakları penceresinde Yeni Veri Kaynağı Ekle'yi seçin.

  3. Veri Kaynağı Türü Seçin ekranında Veritabanı'nı ve ardından İleri'yi seçin.

  4. Veri Bağlantınızı Seçin ekranında aşağıdakilerden birini yapın:

    • Açılan listede Northwind örnek veritabanına bir veri bağlantısı varsa seçin.

      -veya-

    • Bağlantı Ekle/Değiştir iletişim kutusunu başlatmak için Yeni Bağlantı'ya tıklayın.

  5. Veritabanınız parola gerektiriyorsa, hassas verileri dahil etme seçeneğini belirleyin ve ardından İleri'yi seçin.

  6. bağlantı dizesi Uygulama Yapılandırması dosyasına kaydet ekranında İleri'yi seçin.

  7. Veritabanı Nesnelerinizi Seçin ekranında Tablolar düğümünü genişletin.

  8. Region Tabloyu seçin ve ardından Son'u seçin.

    NorthwindDataSet projenize eklenir ve Region tablo Veri Kaynakları penceresinde görüntülenir.

Verileri görüntülemek için forma denetimler ekleme

Öğeleri Veri Kaynakları penceresinden formunuza sürükleyerek veriye bağlı denetimleri oluşturun.

Windows formunda veri bağlama denetimleri oluşturmak için ana Bölge düğümünü Veri Kaynakları penceresinden forma sürükleyin.

DataGridView Formda kayıtlarda gezinmek için bir denetim ve araç şeridi (BindingNavigator). Bileşen tepsisinde bir NorthwindDataSet, RegionTableAdapter, BindingSourceve BindingNavigator görünür.

Tek tek TableAdapter DbDirect yöntemlerini çağıracak düğmeler eklemek için

  1. Araç Kutusundan Form1'e üç Button denetim sürükleyin (RegionDataGridView'un altına).

  2. Her düğmede aşağıdaki Ad ve Metin özelliklerini ayarlayın.

    Veri Akışı Adı Metin
    InsertButton Ekle
    UpdateButton Güncelleştirme
    DeleteButton Silme

Veritabanına yeni kayıtlar eklemek için kod eklemek için

  1. Tıklama olayı için bir olay işleyicisi oluşturmak ve formunuzu kod düzenleyicisinde açmak için EkleDüğmesini seçin.

  2. Olay işleyicisini InsertButton_Click aşağıdaki kodla değiştirin:

    private void InsertButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    String newRegionDescription = "NorthEastern";

    try
    {
        regionTableAdapter1.Insert(newRegionID, newRegionDescription);
    }
    catch (Exception ex)
    {
        MessageBox.Show("Insert Failed");
    }
    RefreshDataset();
}


private void RefreshDataset()
{
    this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
}

    Not

    Visual Studio sürümünüze ve kullandığınız proje şablonlarına bağlı olarak, bu kodda kullanılan veya regionTableAdapter1 bu regionTableAdapter kodda kullanılan değişken adları, oluşturulan kodda sonunda 1 olabilir veya olmayabilir. Doğru adın her yerde kullanıldığından emin olmak için kodunuzda düzeltmeler yapın. Visual Studio, adın yanlış olduğu kırmızı bir dalgalı çizgi gösterir.

Veritabanındaki kayıtları güncelleştirmek için kod eklemek için

  1. UpdateButton düğmesine çift tıklayarak tıklama olayı için bir olay işleyicisi oluşturun ve formunuzu kod düzenleyicisinde açın.

  2. Olay işleyicisini UpdateButton_Click aşağıdaki kodla değiştirin:

    private void UpdateButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    
    try
    {
        regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Update Failed");
    }
    RefreshDataset();
}

Veritabanından kayıtları silmek için kod eklemek için

  1. DeleteButton öğesini seçerek tıklama olayı için bir olay işleyicisi oluşturun ve formunuzu kod düzenleyicisinde açın.

  2. Olay işleyicisini DeleteButton_Click aşağıdaki kodla değiştirin:

    private void DeleteButton_Click(object sender, EventArgs e)
{
    try
    {
        regionTableAdapter1.Delete(5, "Updated Region Description");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Delete Failed");
    }
    RefreshDataset();
}

Uygulamayı çalıştırma

  • Uygulamayı çalıştırmak için F5'i seçin.

  • Ekle düğmesini seçin ve yeni kaydın kılavuzda göründüğünü doğrulayın.

  • Güncelleştir düğmesini seçin ve kaydın kılavuzda güncelleştirildiğini doğrulayın.

  • Sil düğmesini seçin ve kaydın kılavuzdan kaldırıldığını doğrulayın.

Sonraki adımlar

Uygulama gereksinimlerinize bağlı olarak, veriye bağlı form oluşturduktan sonra gerçekleştirmek isteyebileceğiniz birkaç adım vardır. Bu öğreticide yapabileceğiniz bazı geliştirmeler şunlardır:

  • Forma arama işlevi ekleme.

  • Veri Kaynakları penceresinin içinden DataSet'i Sihirbazla Yapılandır'ı seçerek veri kümesine ek tablolar ekleyin. İlgili düğümleri forma sürükleyerek ilgili verileri görüntüleyen denetimler ekleyebilirsiniz. Daha fazla bilgi için bkz . Veri Kümelerindeki İlişkiler.

İlgili içerik