Een .NET Framework Windows Forms-gebruikersbeheer maken dat ondersteuning biedt voor complexe gegevensbinding met ADO.NET

Opmerking

De DataSet klassen en gerelateerde klassen zijn verouderde .NET Framework-technologieën uit het begin van de jaren 2000 waarmee toepassingen met gegevens in het geheugen kunnen werken terwijl de apps losgekoppeld zijn van de database. De technologieën zijn vooral handig voor apps waarmee gebruikers gegevens kunnen wijzigen en de wijzigingen weer kunnen behouden in de database. Hoewel gegevenssets een bewezen succesvolle technologie zijn, is de aanbevolen aanpak voor nieuwe .NET-toepassingen het gebruik van Entity Framework Core. Entity Framework biedt een natuurlijkere manier om met tabelgegevens te werken als objectmodellen en heeft een eenvoudigere programmeerinterface.

Wanneer u gegevens weergeeft in formulieren in Windows-toepassingen, kunt u bestaande besturingselementen kiezen in de werkset. U kunt ook aangepaste besturingselementen maken als uw toepassing functionaliteit vereist die niet beschikbaar is in de standaardbesturingselementen. In deze stapsgewijze instructie ziet u hoe u een besturingselement maakt waarmee het ComplexBindingPropertiesAttribute wordt geïmplementeerd. Besturingselementen waarmee de ComplexBindingPropertiesAttribute gegevens worden geïmplementeerd, bevatten een DataSource en DataMember eigenschap die aan gegevens kunnen worden gebonden. Dergelijke controles zijn vergelijkbaar met een DataGridView of ListBox.

Zie Windows Forms-besturingselementen ontwikkelen tijdens het ontwerp voor meer informatie over het ontwerpen van besturingselementen.

Bij het ontwerpen van besturingselementen voor gebruik in scenario's voor gegevensbinding moet u een van de volgende kenmerken voor gegevensbinding implementeren:

Gebruik van gegevensbindingskenmerken
Implementeer DefaultBindingPropertyAttribute op eenvoudige bedieningselementen, zoals een TextBox, die één kolom (of een eigenschap) weergeven. Zie Een Gebruikersbeheer voor Windows Forms maken dat eenvoudige gegevensbinding ondersteunt voor meer informatie.
Implementeer de ComplexBindingPropertiesAttribute op besturingselementen, zoals een DataGridView, die lijsten (of tabellen) met gegevens weergeven. (Dit proces wordt beschreven op deze overzichtspagina.)
Implementeer de LookupBindingPropertiesAttribute op besturingselementen, zoals een ComboBox, die lijsten (of tabellen) met gegevens weergeven maar ook een enkele kolom of eigenschap moeten presenteren. Zie Een Windows Forms-gebruikersbeheer maken dat ondersteuning biedt voor opzoekgegevensbinding voor meer informatie.

In deze walkthrough wordt een complex controle-element gemaakt waarin rijen met gegevens uit een tabel worden weergegeven. In dit voorbeeld wordt de Customers tabel uit de voorbeelddatabase Northwind gebruikt. Het complexe gebruikersbeheer geeft de tabel klanten weer in een DataGridView in het aangepaste besturingselement.

Tijdens deze doorloop leert u het volgende:

• Voeg een nieuw gebruikersbeheer toe aan uw project.

• Ontwerp het gebruikersbeheer visueel.

• Implementeer het ComplexBindingProperty kenmerk.

• Maak een gegevensset met de Gegevensbronconfiguratie Wizard.

• Stel de tabel Klanten in het venster Gegevensbronnen in om het nieuwe complexe besturingselement te gebruiken.

• Voeg het nieuwe besturingselement toe door het vanuit het venster Gegevensbronnen naar Form1 te slepen.

Vereiste voorwaarden

Voor het voltooien van deze zelfstudie hebt u de ontwikkel- en gegevensopslag- en verwerkingsworkloads van .NET nodig die zijn geïnstalleerd in Visual Studio. Als u deze wilt installeren, opent u Visual Studio Installer en kiest u Wijzigen (of Meer>Wijzigen) naast de versie van Visual Studio die u wilt wijzigen. Zie Visual Studio wijzigen.

In dit scenario worden SQL Server Express LocalDB en de Northwind-voorbeelddatabase gebruikt.

1. Als u geen SQL Server Express LocalDB hebt, installeert u deze via de downloadpagina van SQL Server Express of via het installatieprogramma van Visual Studio. In de Visual Studio Installerkunt u SQL Server Express LocalDB installeren als onderdeel van de Gegevensopslag en -verwerking workload of als een afzonderlijk onderdeel.

2. Installeer de Northwind-voorbeelddatabase door de volgende stappen uit te voeren:

   1. Open in Visual Studio het venster SQL Server-objectverkenner. (SQL Server Object Explorer wordt geïnstalleerd als onderdeel van de werkbelasting voor gegevensopslag en -verwerking in het Installatieprogramma van Visual Studio.) Vouw het SQL Server-knooppunt uit. Klik met de rechtermuisknop op uw LocalDB-exemplaar en selecteer Nieuwe query.

      Er wordt een venster van de queryeditor geopend.

   2. Kopieer het script Northwind Transact-SQL naar het klembord. Met dit T-SQL-script wordt de volledig nieuwe Northwind-database gemaakt en gevuld met gegevens.

   3. Plak het T-SQL-script in de queryeditor en kies vervolgens de knop uitvoeren.

      Na korte tijd wordt de query uitgevoerd en wordt de Northwind-database gemaakt.

Een Windows Forms-app-project maken

De eerste stap is het maken van een Windows Forms App-project voor C# of Visual Basic. Geef het project de naam ComplexControlWalkthrough.

Een gebruikersbeheer toevoegen aan het project

Omdat in deze procedure een complex besturingselement voor gegevensbinding wordt gemaakt op basis van een gebruikersbesturingselement, voegt u het gebruikersbesturingselement toe aan het project.

1. Kies Gebruikersbeheer toevoegen in het menu Project.

2. Typ ComplexDataGridView in het Naamgebied en selecteer Toevoegen.

   Het besturingselement ComplexDataGridView wordt toegevoegd aan Solution Explorer en wordt geopend in de ontwerpfunctie.

Het besturingselement ComplexDataGridView ontwerpen

Als u een DataGridView aan het gebruikersbeheer wilt toevoegen, sleept u een DataGridView van de werkset naar het ontwerpoppervlak van het gebruikersbeheer.

Het vereiste kenmerk voor gegevensbinding toevoegen

Voor complexe besturingselementen die ondersteuning bieden voor gegevensbinding, kunt u het ComplexBindingPropertiesAttributevolgende implementeren:

1. Schakel het besturingselement ComplexDataGridView over naar de codeweergave. (Selecteer Code in het menu Beeld.)

2. Vervang de code in het ComplexDataGridView volgende:

   C#

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
       public partial class ComplexDataGridView : UserControl
       {
           public object DataSource
           {
               get{ return dataGridView1.DataSource; }
               set{ dataGridView1.DataSource = value; }
           }
   
           public string DataMember
           {
               get{ return dataGridView1.DataMember; }
               set{ dataGridView1.DataMember = value; }
           }
   
           public ComplexDataGridView()
           {
               InitializeComponent();
           }
       }
   }
   

   VB

   <System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
   Public Class ComplexDataGridView
   
       Public Property DataSource() As Object
           Get
               Return DataGridView1.DataSource
           End Get
           Set(ByVal value As Object)
               DataGridView1.DataSource = value
           End Set
       End Property
   
       Public Property DataMember() As String
           Get
               Return DataGridView1.DataMember
           End Get
           Set(ByVal value As String)
               DataGridView1.DataMember = value
           End Set
       End Property
   End Class
   

3. Kies Build Solution in het menu Build.

Een gegevensbron maken op basis van uw database

Gebruik de wizard Gegevensbronconfiguratie om een gegevensbron te maken op basis van de Customers tabel in de Northwind-voorbeelddatabase:

1. Als u het venster Gegevensbronnen wilt openen, klikt u in het menu Gegevens op Gegevensbronnen weergeven.

2. Selecteer in het venster Gegevensbronnen de optie Nieuwe gegevensbron toevoegen om de wizard Gegevensbronconfiguratie te starten.

3. Selecteer Database op de pagina Een gegevensbrontype kiezen en selecteer vervolgens Volgende.

4. Voer op de pagina Uw gegevensverbinding kiezen een van de volgende handelingen uit:

   • Als een gegevensverbinding met de voorbeelddatabase Northwind beschikbaar is in de vervolgkeuzelijst, selecteert u deze.

   • Selecteer Nieuwe verbinding om het dialoogvenster Verbinding toevoegen/wijzigen te openen.

5. Als uw database een wachtwoord vereist, selecteert u de optie om gevoelige gegevens op te nemen en klikt u vervolgens op Volgende.

6. Klik op de pagina Verbindingsreeks opslaan naar het Configuratiebestand van de Toepassing op Volgende.

7. Vouw op de pagina Databaseobjecten kiezen het knooppunt Tabellen uit.

8. Selecteer de Customers tabel en selecteer Voltooien.

   De NorthwindDataSet wordt toegevoegd aan uw project en de Customers tabel wordt weergegeven in het venster Gegevensbronnen .

Stel de tabel Klanten in om het besturingselement ComplexDataGridView te gebruiken

In het venster Gegevensbronnen kunt u instellen dat het besturingselement moet worden gemaakt voordat u items naar het formulier sleept:

1. Open Form1- in de ontwerpfunctie.

2. Vouw het knooppunt Klanten uit in het venster Gegevensbronnen .

3. Klik op de vervolgkeuzepijl op het knooppunt Klanten en kies Aanpassen.

4. Selecteer de ComplexDataGridView in de lijst van gekoppelde bedieningselementen in het dialoogvenster Aanpassingsopties Gegevens-UI.

5. Klik op de pijl van de vervolgkeuzelijst in de Customers tabel en kies ComplexDataGridView in de besturingslijst.

Besturingselementen toevoegen aan het formulier

U kunt de gegevensgebonden besturingselementen maken door items uit het venster Gegevensbronnen naar uw formulier te slepen. Sleep het hoofdknooppunt Klanten vanuit het venster Gegevensbronnen naar het formulier. Controleer of het besturingselement ComplexDataGridView wordt gebruikt om de gegevens van de tabel weer te geven.

De toepassing uitvoeren

Druk op F5- om de toepassing uit te voeren.

Volgende stappen

Afhankelijk van uw toepassingsvereisten zijn er verschillende stappen die u mogelijk wilt uitvoeren nadat u een besturingselement hebt gemaakt dat ondersteuning biedt voor gegevensbinding. Enkele typische volgende stappen zijn:

• Plaats uw aangepaste besturingselementen in een besturingsbibliotheek, zodat u ze opnieuw kunt gebruiken in andere toepassingen.

• Besturingselementen maken die ondersteuning bieden voor opzoekscenario's. Zie Een Windows Forms-gebruikersbeheer maken dat ondersteuning biedt voor opzoekgegevensbinding voor meer informatie.

Verwante inhoud

• Besturingselementen voor Windows Forms binden aan gegevens in Visual Studio
• Stel het besturingselement in dat moet worden gemaakt bij het verslepen uit het Data-bronnen venster
• Windows Forms-Besturingselementen