ADO.NET uygulamalarına yeni veri kaynakları ekleme (.NET Framework)

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. Bunlar ö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.

Not

Bu makalede açıklanan özellikler .NET Framework Windows Forms ve WPF geliştirme için geçerlidir. Özellikler hem WPF hem de Windows Forms için .NET Core geliştirme için desteklenmez.

Visual Studio'daki .NET veri araçları bağlamında, veri kaynağı terimi bir veri deposuna bağlanan ve verileri bir .NET uygulaması için kullanılabilir hale getiren .NET nesnelerini ifade eder. Visual Studio tasarımcıları, Veri Kaynakları penceresinden veritabanı nesnelerini sürükleyip bıraktığınızda verileri formlara bağlayan ortak kodu oluşturmak için veri kaynağının çıktısını kullanabilir. Bu tür bir veri kaynağı şu olabilir:

  • Bir tür veritabanıyla ilişkilendirilmiş bir Entity Framework modelindeki bir sınıf.

  • Bir tür veritabanıyla ilişkilendirilmiş bir veri kümesi.

  • Windows Communication Foundation (WCF) veri hizmeti veya REST hizmeti gibi bir ağ hizmetini temsil eden bir sınıf.

  • SharePoint hizmetini temsil eden bir sınıf.

  • Çözümünüzdeki bir sınıf veya koleksiyon.

Not

Veri bağlama özellikleri, veri kümeleri, Entity Framework, LINQ to SQL, WCF veya SharePoint kullanmıyorsanız, "veri kaynağı" kavramı geçerli değildir. SQLCommand nesnelerini kullanarak doğrudan veritabanına bağlanmalı ve veritabanıyla doğrudan iletişim kurabilirsiniz.

Bir Windows Forms veya Windows Presentation Foundation uygulamasında Veri Kaynağı Yapılandırma Sihirbazı'nı kullanarak veri kaynakları oluşturur ve düzenlersiniz. Entity Framework için önce varlık sınıflarınızı oluşturun ve ardından Proje>Yeni Veri Kaynağı Ekle'yi seçerek sihirbazı başlatın (bu makalenin devamında daha ayrıntılı olarak açıklanmıştır).

Veri Kaynağı Yapılandırma Sihirbazı

Veri Kaynakları penceresi

Bir veri kaynağı oluşturduktan sonra, veri kaynakları araç penceresinde görüntülenir.

İpucu

Veri Kaynakları penceresini açmak için projenizin açık olduğundan emin olun ve Shift Alt+D tuşuna+basın veya Diğer Windows>Veri Kaynaklarını Görüntüle'yi>seçin.

.NET Framework'e (.NET Core veya .NET 5 veya üzerini değil) hedefleyen bir Windows Forms projesinde, veri kaynağını Veri Kaynakları penceresinden form tasarım yüzeyine veya denetimine sürükleyebilirsiniz. Tabloyu sürüklerseniz, tablo için BindingNavigator ve DataGridView alırsınız. Tek bir sütunu sürüklerseniz, bir BindingNavigator, bir Label ve bu sütun için TextBoxelde edersiniz. Bir tablonun tam veri görüntüleme formunu almak için sütunları sürükleyin. Bu eylemler, veri deposundaki verileri görüntüleyen ortak kodun oluşturulmasına neden olur.

Aşağıdaki çizimde, Windows formuna bırakılan bir veri kümesi gösterilmektedir. Uygulamada F5'i seçerseniz, formun denetimlerinde temel alınan veritabanındaki veriler görüntülenir.

Veri Kaynağı sürükleme işlemini gösteren ekran görüntüsü.

Veri Kaynağı sürükleme işlemini gösteren ekran görüntüsü.

Veritabanı veya veritabanı dosyası için veri kaynağı

Veritabanı veya veritabanı dosyası için veri kaynağı olarak kullanmak üzere bir veri kümesi veya Entity Framework modeli oluşturabilirsiniz.

Veri kümesi

Veri kaynağı olarak veri kümesi oluşturmak için Proje Yeni Veri Kaynağı Ekle'yi seçerek> Veri Kaynağı Yapılandırma Sihirbazı'nı çalıştırın. Veritabanı veri kaynağı türünü seçin ve istemleri izleyerek yeni veya var olan bir veritabanı bağlantısını ya da bir veritabanı dosyasını belirtin.

Varlık sınıfları

Veri kaynağı olarak bir Entity Framework modeli oluşturmak için:

  1. Varlık sınıflarını oluşturmak için Varlık Veri Modeli Sihirbazı'nı çalıştırın. Proje>Varlık Veri Modeli ADO.NET Yeni Öğe>Ekle'yi seçin.

    Yeni Entity Framework modeli proje öğesi

  2. Modeli oluşturmak istediğiniz yöntemi seçin.

    Varlık Veri Modeli Sihirbazı

  3. Modeli veri kaynağı olarak ekleyin. Oluşturulan sınıflar, Nesneler kategorisini seçtiğinizde Veri Kaynağı Yapılandırma Sihirbazı'nda görünür.

    Varlık Sınıflarıyla Veri Kaynağı Yapılandırma Sihirbazı

Hizmet için veri kaynağı

Hizmetten veri kaynağı oluşturmak için Veri Kaynağı Yapılandırma Sihirbazı'nı çalıştırın ve Hizmet veri kaynağı türünü seçin. Bu eylem, Çözüm Gezgini'da projeye sağ tıklayıp Hizmet başvurusu ekle'yi seçerek de erişebileceğiniz Hizmet Başvurusu Ekle iletişim kutusunun kısayoludur.

Bir hizmetten veri kaynağı oluşturduğunuzda, Visual Studio projenize bir hizmet başvurusu ekler. Visual Studio, hizmetin döndürdüğü nesnelere karşılık gelen ara sunucu nesneleri de oluşturur. Örneğin, veri kümesi döndüren bir hizmet projenizde veri kümesi olarak temsil edilir; belirli bir tür döndüren bir hizmet, projenizde döndürülen tür olarak gösterilir.

Aşağıdaki hizmet türlerinden bir veri kaynağı oluşturabilirsiniz:

  • WCF Veri Hizmetleri

  • WCF hizmetleri

  • Web hizmetleri

    Not

    Veri Kaynakları penceresinde görüntülenen öğeler, hizmetin döndürdüğü verilere bağlıdır. Bazı hizmetler, Bağlanabilir nesneler oluşturmak için Veri Kaynağı Yapılandırma Sihirbazı için yeterli bilgi sağlamayabilir. Örneğin, hizmet yazılmamış bir veri kümesi döndürürse, sihirbazı tamamladığınızda Veri Kaynakları penceresinde hiçbir öğe görünmez. Bunun nedeni, yazılmamış veri kümelerinin şema sağlamaması ve dolayısıyla sihirbazın veri kaynağını oluşturmak için yeterli bilgiye sahip olmamasıdır.

Nesne için veri kaynağı

Veri Kaynağı Yapılandırma Sihirbazı'nı çalıştırıp Nesne veri kaynağı türünü seçerek bir veya daha fazla genel özelliği kullanıma sunan herhangi bir nesneden veri kaynağı oluşturabilirsiniz. Bir nesnenin tüm genel özellikleri Veri Kaynakları penceresinde görüntülenir. Entity Framework kullanıyorsanız ve bir model oluşturduysanız, uygulamanızın veri kaynakları olan varlık sınıflarını burada bulabilirsiniz.

Veri Nesnelerini Seçin sayfasında, bağlanmak istediğiniz nesneleri bulmak için ağaç görünümündeki düğümleri genişletin. Ağaç görünümü, projeniz ve derlemeler ve projeniz tarafından başvurulan diğer projeler için düğümler içerir.

Bir derlemedeki veya projedeki ağaç görünümünde görünmeyen bir nesneye bağlanmak istiyorsanız, Başvuru Ekle'ye tıklayın ve derlemeye veya projeye başvuru eklemek için Başvuru Ekle İletişim Kutusunu kullanın. Başvuruyu ekledikten sonra, derleme veya proje ağaç görünümüne eklenir.

Not

Nesneler ağaç görünümünde görünmeden önce nesnelerinizi içeren projeyi oluşturmanız gerekebilir.

Not

Sürükle ve bırak veri bağlamasını desteklemek için veya IListSource arabirimini ITypedList uygulayan nesnelerin varsayılan bir oluşturucuya sahip olması gerekir. Aksi takdirde, Visual Studio veri kaynağı nesnesinin örneğini oluşturamaz ve öğeyi tasarım yüzeyine sürüklediğinizde bir hata görüntüler.

SharePoint listesi için veri kaynağı

Veri Kaynağı Yapılandırma Sihirbazı'nı çalıştırıp SharePoint veri kaynağı türünü seçerek SharePoint listesinden veri kaynağı oluşturabilirsiniz. SharePoint WCF Veri Hizmetleri aracılığıyla verileri kullanıma sunar, bu nedenle SharePoint veri kaynağı oluşturmak, hizmetten veri kaynağı oluşturmakla aynıdır. Veri Kaynağı Yapılandırma Sihirbazı'nda SharePoint öğesini seçtiğinizde, SharePoint Sunucusu'na işaret ederek SharePoint veri hizmetine bağlandığınız Hizmet Başvurusu Ekle iletişim kutusu açılır. Bu eylem, SharePoint SDK'sını gerektirir.