Basit veri bağlamayı destekleyen bir .NET Framework Windows Forms kullanıcı denetimi oluşturma

Windows uygulamalarında formlardaki verileri görüntülerken, Araç Kutusu'ndan mevcut denetimleri seçebilir veya uygulamanız standart denetimlerde bulunmayan işlevler gerektiriyorsa özel denetimler yazabilirsiniz. Bu izlenecek yol, uygulamasını uygulayan DefaultBindingPropertyAttributebir denetimin nasıl oluşturulacağını gösterir. uygulayan DefaultBindingPropertyAttribute denetimler, verilere bağlanabilen bir özellik içerebilir. Bu tür denetimler veya TextBox CheckBoxile benzerdir.

Denetim yazma hakkında daha fazla bilgi için bkz . Tasarım Zamanında Windows Forms Denetimleri Geliştirme.

Veri bağlama senaryolarında kullanmak üzere denetimler yazarken, aşağıdaki veri bağlama özniteliklerinden birini uygulamanız gerekir:

Bu izlenecek yol, tablodaki tek bir sütundaki verileri görüntüleyen basit bir denetim oluşturur. Bu örnek, Northwind örnek veritabanındaki Customers tablonun sütununu kullanırPhone. Basit kullanıcı denetimi, bir kullanarak MaskedTextBox ve maskeyi bir telefon numarasına ayarlayarak müşterilerin telefon numaralarını standart bir telefon numarası biçiminde görüntüler.

Bu kılavuzda şunların nasıl yapılacağını öğreneceksiniz:

• Yeni bir Windows Forms Uygulaması (.NET Framework) oluşturun.

• Projenize yeni bir Kullanıcı Denetimi ekleyin.

• Kullanıcı denetimini görsel olarak tasarlar.

• özniteliğini DefaultBindingProperty uygulayın.

• Veri Kaynağı Yapılandırma sihirbazıyla bir veri kümesi oluşturun.

• Yeni denetimi kullanmak için Veri Kaynakları penceresindeki Telefon sütununu ayarlayın.

• Yeni denetimde verileri görüntülemek için bir form oluşturun.

Önkoşullar

Bu öğreticiyi tamamlamak için Visual Studio'da yüklü .NET masaüstü geliştirme ve Veri depolama ve işleme iş yüklerine ihtiyacınız vardır. Bunları yüklemek için Visual Studio Yükleyicisi açın ve değiştirmek istediğiniz Visual Studio sürümünün yanındaki Değiştir (veya Daha Fazla>Değiştir) öğesini seçin. Bkz. Visual Studio'yu değiştirme.

Bu kılavuzda 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:

1. Visual Studio'da, Dosya menüsünde Yeni Proje'yi> seçin.

2. Sol bölmede Visual C# veya Visual Basic'i genişletin, ardından Windows Masaüstü'nü seçin.

3. Orta bölmede Windows Forms Uygulaması proje türünü seçin.

4. Projeye SimpleControlWalkthrough adını verin ve Tamam'ı seçin.

   SimpleControlWalkthrough projesi oluşturulur ve Çözüm Gezgini eklenir.

Projeye kullanıcı denetimi ekleme

Bu izlenecek yol, kullanıcı denetiminden basit bir veri bağlanabilir denetim oluşturur. SimpleControlWalkthrough projesine kullanıcı denetimi öğesi ekleyin:

1. Proje menüsünden Kullanıcı Denetimi Ekle'yi seçin.

2. Ad alanına PhoneNumberBox yazın ve Ekle'ye tıklayın.

   PhoneNumberBox denetimi Çözüm Gezgini eklenir ve tasarımcıda açılır.

PhoneNumberBox denetimini tasarlama

Bu izlenecek yol, PhoneNumberBox denetimini oluşturmak için var olanın MaskedTextBox üzerine genişler:

1. Araç Kutusu'ndan kullanıcı denetiminin tasarım yüzeyine sürükleyinMaskedTextBox.

2. Sürüklediğiniz akıllı etiketi MaskedTextBox seçin ve Maske Ayarla'yı seçin.

3. Giriş Maskesi iletişim kutusunda Telefon numarası'nı seçin ve maskeyi ayarlamak için Tamam'a tıklayın.

Gerekli veri bağlama özniteliğini ekleme

Veri bağlamayı destekleyen basit denetimler için uygulayın DefaultBindingPropertyAttribute:

1. PhoneNumberBox denetimini kod görünümüne getirin. (Görünüm menüsü, Kod'u seçin.)

2. PhoneNumberBox içindeki kodu aşağıdakilerle değiştirin:

   • C#
   • VB

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.DefaultBindingProperty("PhoneNumber")]
       public partial class PhoneNumberBox : UserControl
       {
           public string PhoneNumber
           {
               get{ return maskedTextBox1.Text; }
               set{ maskedTextBox1.Text = value; }
           }
   
           public PhoneNumberBox()
           {
               InitializeComponent();
           }
       }
   }
   

3. Derle menüsünden Çözüm Derle'yi seçin.

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

Bu adım, Northwind örnek veritabanındaki tabloyu temel alan Customers 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.

1. Veri Kaynakları penceresini açmak için, Veri menüsünde Veri Kaynaklarını Göster'e tıklayın.

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 sayfasında Veritabanı'nı ve ardından İleri'yi seçin.

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

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

   • 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 sayfasında İleri'ye tıklayın.

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

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

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

Telefon sütununu PhoneNumberBox denetimini kullanacak şekilde ayarlama

Veri Kaynakları penceresinde, öğeleri formunuza sürüklemeden önce oluşturulacak denetimi ayarlayabilirsiniz:

1. Tasarımcıda Form1'i açın.

2. Veri Kaynakları penceresinde Müşteriler düğümünü genişletin.

3. Müşteriler düğümündeki açılan liste okuna tıklayın ve denetim listesinden Ayrıntılar'ı seçin.

4. Telefon sütunundaki açılan liste okuna tıklayın ve Özelleştir'i seçin.

5. Veri Arabirimi Özelleştirme Seçenekleri iletişim kutusundaki İlişkili Denetimler listesinden PhoneNumberBox'ı seçin.

6. Telefon sütunundaki açılan liste okuna tıklayın ve PhoneNumberBox'ı seçin.

Forma denetim ekleme

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

Formda veriye bağlı denetimler oluşturmak için, Ana Müşteriler düğümünü Veri Kaynakları penceresinden forma sürükleyin ve Phone sütunundaki verileri görüntülemek için PhoneNumberBox denetiminin kullanıldığını doğrulayın.

Formda açıklayıcı etiketler içeren veriye bağlı denetimler ve kayıtlarda gezinmek için bir araç şeridi (BindingNavigator) görüntülenir. NorthwindDataSet, CustomersTableAdapter BindingSourceve BindingNavigator bileşen tepsisinde görünür.

Uygulamayı çalıştırma

Uygulamayı çalıştırmak için F5'e basın.

Sonraki adımlar

Uygulama gereksinimlerinize bağlı olarak, veri bağlamayı destekleyen bir denetim oluşturduktan sonra gerçekleştirmek isteyebileceğiniz birkaç adım vardır. Bazı tipik sonraki adımlar şunlardır:

• Özel denetimlerinizi bir denetim kitaplığına yerleştirerek bunları diğer uygulamalarda yeniden kullanabilirsiniz.

• Daha karmaşık veri bağlama senaryolarını destekleyen denetimler oluşturma. Daha fazla bilgi için bkz. Karmaşık veri bağlamayı destekleyen bir Windows Forms kullanıcı denetimi oluşturma ve Arama veri bağlamasını destekleyen bir Windows Forms kullanıcı denetimi oluşturma.

İlgili içerik

• Visual Studio'da verilere Windows Forms denetimleri bağlama
• Deneti veri kaynakları penceresinden sürüklendiğinde oluşturulacak şekilde ayarlama