ADO.NET uygulamalarında (.NET Framework) veri kaynakları ekleme
Visual Studio'da .NET veri araçlarıyla çalışırken, .NET uygulamanızı veri depolarındaki bilgilere bağlamak için veri kaynakları (.NET nesneleri) ekleyebilirsiniz. Visual Studio tasarımcıları, Veri Kaynakları penceresinden veritabanı nesnelerini sürükleyip bıraktığınızda verileri formlara bağlayan ortak kod oluşturmak için veri kaynağı çıkışını kullanabilir.
Veri kaynaklarına örnek olarak şunlar verilebilir:
Entity Framework modelinde bir tür veritabanıyla ilişkilendirilmiş 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 sınıf
SharePoint hizmetini temsil eden bir sınıf
Çözümünüzdeki bir sınıf veya koleksiyon
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.
Önkoşullar
.NET Framework'i hedefleyen Windows Forms veya Windows Sunu Biçimi (WPF) nesneleri uygulayan bir uygulama. Yüklemeniz .NET Desktop geliştirme iş yükünü içerdiğinde Visual Studio'da bir şablon kullanarak bu tür bir uygulama oluşturabilirsiniz. Daha fazla bilgi için bkz . Visual Studio iş yüklerini, bileşenlerini ve dil paketlerini değiştirme.
Önemli
Bu makalede açıklanan özellikler WPF veya Windows Forms için .NET Core geliştirme için desteklenmez.
Uygulama veri bağlama özelliklerini kullanmalıdır: veri kümeleri, Entity Framework, SQL'e Dil Tümleşik Sorgusu (LINQ), wcf veri hizmeti veya SharePoint.
İpucu
Uygulama bu bileşenlerden birini veya daha fazlasını kullanmadığında, "veri kaynağı" kavramı geçerli değildir. Bu senaryolarda SqlCommand sınıf nesnelerini kullanarak doğrudan veritabanına bağlanabilirsiniz.
Veri kaynakları ve Windows formlarıyla çalışma
Bir Windows Forms veya WPF uygulamasında Veri Kaynağı Yapılandırma Sihirbazı'nı kullanarak .NET Framework için veri kaynakları oluşturup düzenlersiniz. Bir veritabanından, hizmetten, nesneden veya SharePoint listesinden veri kaynağı oluşturabilirsiniz:
Veri kaynaklarını oluşturduktan sonra, bunlar Veri Kaynakları penceresinde görünür. Projeniz Visual Studio'da açıkken, Diğer Windows>Veri Kaynaklarını Görüntüle'yi>seçerek bu pencereye erişebilirsiniz. Shift+Alt+D klavye kısayolunu da kullanabilirsiniz.
.NET Framework'e (.NET Core veya .NET 5 veya üzerini değil) hedefleyen bir Windows Forms projesinde, veri kaynağını Veri Kaynakları penceresinden Windows form tasarım yüzeyine veya denetimine sürükleyebilirsiniz. Bir veri kaynağını forma nasıl bağlayabileceğinize dair bazı örnekler şunlardır:
BindingNavigator ve tablo için DataGridView almak için tabloyu sürükleyin.
Sütunun Label ve TextBox içeren BindingNavigator'ını almak için belirli bir sütunu sürükleyin.
Tablonun tam veri görüntüleme formunu almak için tüm tablo sütunlarını sürükleyin.
Bu eylemler Visual Studio'yu tetikler ve veri deposundaki verileri görüntüleyen ortak kod oluşturur. Aşağıdaki örnekte 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.
Veritabanından veya veritabanı dosyasından veri kaynağı oluşturma
Veri Kaynağı Yapılandırma Sihirbazı ile veritabanı veya veritabanı dosyası için veri kaynağı olarak kullanılacak bir veri kümesi veya Entity Framework modeli oluşturabilirsiniz. Yapılandırmanız Entity Framework kullanıyorsa, önce Varlık sınıflarınızı oluşturun ve ardından veri kaynakları oluşturmak için sihirbazı kullanın.
Veri kaynağı olarak veri kümesi oluşturma
Veri Kaynağı Yapılandırma Sihirbazı, veritabanına bağlanarak veri kaynağı oluşturma seçeneği sağlar. Uygulamanızın veri kümesi olarak kullanılacak veritabanı nesnelerini seçebilirsiniz.
Veri kaynağı olarak veri kümesi oluşturmak için şu adımları izleyin:
Visual Studio'da Proje>Yeni Veri Kaynağı Ekle'yi seçerek Veri Kaynağı Yapılandırma Sihirbazı'nı açın.
Veri kaynağı türü için Veritabanı'nı seçin.
Veritabanı modeli için Veri kümesi'ni seçin.
Yeni veya var olan bir veritabanı bağlantısını veya veritabanı dosyasını belirtmek için istemleri izleyin.
Veri kümesine eklenecek veritabanı nesnelerini seçin ve sihirbazı tamamlayın.
Sihirbazı tamamlamaya yönelik ayrıntılı yönergeler için bkz . Visual Studio ile .NET Framework'te veri kümeleri oluşturma ve yapılandırma.
Veri kaynağı olarak Entity Framework modeli oluşturma
Yapılandırmanız Entity Framework'u kullandığında, önce Varlık sınıflarınızı oluşturursunuz ve ardından veri kaynağını oluşturmak için Veri Kaynağı Yapılandırma Sihirbazı'nı kullanırsınız.
Varlık Veri Modeli Sihirbazı ile veri kaynağı olarak bir Entity Framework modeli oluşturmak için şu adımları izleyin:
Proje>Yeni Öğe Ekle'yi seçin. Yeni Öğe Ekle iletişim kutusu açılır.
İletişim kutusunda ADO.NET Varlık Veri Modeli şablonunu seçin, model örneği için bir ad girin ve Ekle'yi seçin:
Varlık Veri Modeli Sihirbazı açılır.
Sihirbazda Entity Framework modelini oluşturmak için yöntemini seçin:
Veritabanından EF Tasarımcısı: Entity Framework Designer'da var olan bir veritabanını temel alan bir model oluşturur. Modele eklenecek veritabanı bağlantısını, modelin ayarlarını ve veritabanı nesnelerini seçebilirsiniz. Uygulamanızın etkileşimde olduğu sınıflar modelden oluşturulur.
Boş EF Designer modeli: Entity Framework Designer'da modelinizi görsel olarak tasarlamaya yönelik bir başlangıç noktası olarak boş bir model oluşturur. Daha sonra modelinizden bir veritabanı oluşturabilirsiniz. Uygulamanızın etkileşimde olduğu sınıflar modelden oluşturulur.
Boş Kod İlk modeli: Modelinizi kod kullanarak tasarlamaya yönelik başlangıç noktası olarak boş bir Code First modeli oluşturur. Daha sonra modelinizden bir veritabanı oluşturabilirsiniz.
Veritabanından Code First: Mevcut veritabanını temel alan bir Code First modeli oluşturur. Modele eklenecek veritabanı bağlantısını, modelin ayarlarını ve veritabanı nesnelerini seçebilirsiniz.
Seçiminizi yaptıktan sonra, sihirbazda devam etmek için İleri'yi seçin.
Modeli uygulamanızın veri kaynağı olarak ekleyin ve sihirbazı tamamlayın.
Sihirbazı tamamlamaya yönelik ayrıntılı yönergeler için bkz . Entity Framework ile Model Sınıfları Oluşturma (C#).
Model için sınıflar oluşturduktan sonra, Veri Kaynağı Yapılandırma Sihirbazı ile bir nesneden veri kaynağı oluşturabilirsiniz.
Veri kümesinde kullanmak üzere modelden tabloları (veya tek tek sütunları), saklı yordamları, işlevleri ve görünümleri seçin.
Ayrıntılı yönergeler için bkz . Nesneden veri kaynağı oluşturma.
Hizmetten veri kaynağı oluşturma
Veri Kaynağı Yapılandırma Sihirbazı bir hizmetten veri kaynağı oluşturmayı destekler. Bu yaklaşımda, Visual Studio projenize bir hizmet başvurusu ekler ve hizmet tarafından döndürülen nesnelere karşılık gelen ara sunucu nesneleri oluşturur. Bir hizmet veri kümesi döndürdüğünde, hizmet projenizde veri kümesi olarak gösterilir. Hizmet belirli bir tür döndürürse, hizmet projenizde döndürülen tür olarak gösterilir.
Aşağıdaki hizmet türlerinden bir veri kaynağı oluşturabilirsiniz:
Web hizmetleri
Not
Veri Kaynakları penceresindeki öğeler, hizmet tarafından döndürülen verilere bağımlıdır. Bazı hizmetler, Bağlanabilir nesneler oluşturmak için Veri Kaynağı Yapılandırma Sihirbazı için yeterli bilgi sağlamayabilir. Sihirbazı tamamladıktan sonra, hizmet yazılmamış bir veri kümesi döndürürse, Veri Kaynakları penceresinde hiçbir öğe görünmez. Yazılmamış veri kümeleri şema sağlamaz, bu nedenle sihirbaz veri kaynağını oluşturmak için yeterli bilgiye sahip değildir.
Hizmetten veri kaynağı oluşturmak için şu adımları izleyin:
Visual Studio'da Proje>Yeni Veri Kaynağı Ekle'yi seçerek Veri Kaynağı Yapılandırma Sihirbazı'nı açın.
Veri kaynağı türü için Hizmet'i seçin.
Hizmet Başvurusu Ekle iletişim kutusu açılır. Ayrıca Çözüm Gezgini'da projenize sağ tıklayıp Hizmet başvurusu ekle'yi seçerek de bu iletişim kutusuna erişebilirsiniz.
Sihirbazı tamamlamaya yönelik ayrıntılı yönergeler için bkz . Visual Studio ile .NET Framework'te veri kümeleri oluşturma ve yapılandırma.
Nesneden veri kaynağı oluşturma
Veri Kaynağı Yapılandırma Sihirbazı, bir veya daha fazla genel özelliği kullanıma sunan herhangi bir nesneden veri kaynağı oluşturmanıza da olanak tanır.
Bir nesnenin tüm genel özellikleri Veri Kaynakları penceresinde görünür. Entity Framework'i oluşturulan bir modelle kullanıyorsanız, bu pencere uygulamanızın veri kaynakları olan varlık sınıflarını gösterir.
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österir.
Bir nesneden veri kaynağı oluşturmak için şu adımları izleyin:
Visual Studio'da Proje>Yeni Veri Kaynağı Ekle'yi seçerek Veri Kaynağı Yapılandırma Sihirbazı'nı açın.
Veri kaynağı türü için Nesne'yi seçin.
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 için Başvuru Ekle'yi seçin.
Derlemeye veya projeye başvuru eklemek için Başvuru Yöneticisi iletişim kutusunu kullanın. Başvuruyu ekledikten sonra Visual Studio, derlemeyi veya projeyi ağaç görünümüne ekler.
Not
Nesneler ağaç görünümünde görünmeden önce nesnelerinizi içeren projeyi oluşturmanız gerekebilir.
Sihirbazı tamamlamaya yönelik ayrıntılı yönergeler için bkz . Visual Studio ile .NET Framework'te veri kümeleri oluşturma ve yapılandırma.
SharePoint listesinden veri kaynağı oluşturma
SharePoint listesinden veri kaynağı oluşturmak için Veri Kaynağı Yapılandırma Sihirbazı'nı da kullanabilirsiniz. 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.
Not
Bu yaklaşım, SharePoint SDK'sını gerektirir.
SharePoint listesinden veri kaynağı oluşturmak için şu adımları izleyin:
Visual Studio'da Proje>Yeni Veri Kaynağı Ekle'yi seçerek Veri Kaynağı Yapılandırma Sihirbazı'nı açın.
Veri kaynağı türü için SharePoint'i seçin.
SharePoint Server'a işaret ederek SharePoint veri hizmetine bağlanmak için Hizmet Başvurusu Ekle iletişim kutusunu kullanın.
Sihirbazı tamamlamaya yönelik ayrıntılı yönergeler için bkz . Visual Studio ile .NET Framework'te veri kümeleri oluşturma ve yapılandırma.
İlgili içerik
- .NET için Visual Studio veri araçlarını keşfetme
- Visual Studio ile .NET Framework'te veri kümeleri oluşturma ve yapılandırma