Procédure pas à pas : création d'un contrôle utilisateur Windows Forms prenant en charge la liaison de données de recherche
Pour afficher des données dans des formulaires Windows, vous pouvez choisir des contrôles existants dans la Boîte à outils ou créer des contrôles personnalisés si votre application requiert des fonctionnalités qui ne sont pas disponibles dans les contrôles standard. Cette procédure pas à pas vous indique comment créer un contrôle qui implémente l'objet LookupBindingPropertiesAttribute. Les contrôles qui implémentent LookupBindingPropertiesAttribute peuvent contenir trois propriétés pouvant être liées aux données. Ce type de contrôles est similaire à ComboBox.
Pour plus d'informations sur la création de contrôles, consultez Développement de contrôles Windows Forms au moment du design.
Quand vous créez des contrôles utilisables dans des scénarios de liaison de données, vous devez implémenter l'un des attributs Databinding suivants :
Utilisation de l'attribut Databinding |
---|
Implémentez DefaultBindingPropertyAttribute sur des contrôles simples, comme TextBox, qui affichent une seule colonne (ou propriété) de données. Pour plus d'informations, consultez Procédure pas à pas : création d'un contrôle utilisateur Windows Forms prenant en charge la liaison de données simple. |
Implémentez ComplexBindingPropertiesAttribute sur des contrôles, comme DataGridView, qui affichent des listes (ou tables) de données. Pour plus d'informations, consultez Procédure pas à pas : création d'un contrôle utilisateur Windows Forms prenant en charge la liaison de données complexe. |
Implémentez LookupBindingPropertiesAttribute sur des contrôles, comme ComboBox, qui affichent des listes (ou tables) de données, mais doivent également présenter une seule colonne ou propriété. (Ce processus est décrit dans cette page de procédure pas à pas.) |
Cette procédure pas à pas crée un contrôle de recherche qui effectue une liaison vers les données de deux tables. Cet exemple utilise les tables Customers et Orders de l'exemple de base de données Northwind. Le contrôle de recherche sera lié au champ CustomerID de la table Orders. Il utilisera cette valeur pour rechercher le CompanyName dans la table Customers.
Pendant cette procédure pas à pas, vous allez apprendre à :
Créer une application Windows.
Ajouter un nouveau Contrôle utilisateur à votre projet.
Concevoir visuellement le contrôle utilisateur.
Implémenter l'attribut LookupBindingProperty.
Créer un dataset à l'aide de l'Configuration de source de données (Assistant).
Définir la colonne CustomerID de la table Orders dans la fenêtre Sources de données pour qu'elle utilise le nouveau contrôle.
Créer un formulaire pour afficher des données dans le nouveau contrôle.
Composants requis
Pour exécuter cette procédure pas à pas, vous avez besoin des éléments suivants :
- avoir accès à l'exemple de base de données Northwind. Pour plus d'informations, consultez Comment : installer des exemples de bases de données.
Création d'une application Windows
La première étape consiste à créer une application Windows.
Pour créer un projet Windows
Dans Visual Studio, dans le menu Fichier, créez un Projet.
Attribuez le nom LookupControlWalkthrough au projet.
Sélectionnez Application Windows et cliquez sur OK. Pour plus d'informations, consultez Développement d'applications clientes.
Le projet LookupControlWalkthrough est créé et ajouté à l'Explorateur de solutions.
Ajout d'un contrôle utilisateur au projet
Cette procédure pas à pas crée un contrôle de recherche à partir d'un Contrôle utilisateur, vous devez donc ajouter un élément Contrôle utilisateur au projet LookupControlWalkthrough.
Pour ajouter un contrôle utilisateur au projet
Dans le menu Projet, choisissez Ajouter un contrôle utilisateur.
Tapez LookupBox dans la zone Nom, puis cliquez sur Ajouter.
Le contrôle LookupBox est ajouté à l'Explorateur de solutions et s'ouvre dans le concepteur.
Conception du contrôle LookupBox
Pour concevoir le contrôle LookupBox
- Faites glisser un ComboBox depuis la Boîte à outils vers l'aire de conception du contrôle utilisateur.
Ajout de l'attribut Databinding requis
Pour des contrôles de recherche prenant en charge la liaison de données, vous pouvez implémenter l'attributLookupBindingPropertiesAttribute.
Pour implémenter l'attribut LookupBindingProperties
Basculez le contrôle LookupBox sur le mode Code. (Dans le menu Affichage, choisissez Code.)
Remplacez le code de LookupBox par le code suivant :
<System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")> Public Class LookupBox Public Property DataSource() As Object Get Return ComboBox1.DataSource End Get Set(ByVal value As Object) ComboBox1.DataSource = value End Set End Property Public Property DisplayMember() As String Get Return ComboBox1.DisplayMember End Get Set(ByVal value As String) ComboBox1.DisplayMember = value End Set End Property Public Property ValueMember() As String Get Return ComboBox1.ValueMember End Get Set(ByVal value As String) ComboBox1.ValueMember = value End Set End Property Public Property LookupMember() As String Get Return ComboBox1.SelectedValue.ToString() End Get Set(ByVal value As String) ComboBox1.SelectedValue = value End Set End Property End Class
using System.Windows.Forms; namespace CS { [System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")] public partial class LookupBox : UserControl { public object DataSource { get{ return comboBox1.DataSource; } set{ comboBox1.DataSource = value; } } public string DisplayMember { get{ return comboBox1.DisplayMember; } set{ comboBox1.DisplayMember = value; } } public string ValueMember { get{ return comboBox1.ValueMember; } set{ comboBox1.ValueMember = value; } } public string LookupMember { get{ return comboBox1.SelectedValue.ToString(); } set{ comboBox1.SelectedValue = value; } } public LookupBox() { InitializeComponent(); } } }
Dans le menu Générer, cliquez sur Générer la solution.
Création d'une source de données à partir de votre base de données
Cette étape crée une source de données à l'aide de l'Assistant Configuration de source de données basée sur les tables Customers et Orders de l'exemple de base de données Northwind. Vous devez avoir accès à l'exemple de base de données Northwind pour créer la connexion. Pour plus d'informations sur la configuration de l'exemple de base de données Northwind, consultez Comment : installer des exemples de bases de données.
Pour créer la source de données
Dans le menu Données, cliquez sur Afficher les sources de données.
Dans la fenêtre Sources de données, sélectionnez Ajouter une nouvelle source de données pour démarrer l'Assistant Configuration de source de données.
Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.
Dans la page Choisir votre connexion de données, effectuez l'une des opérations suivantes :
Si une connexion de données à l'exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.
ou
Sélectionnez Nouvelle connexion pour afficher la boîte de dialogue Ajouter/Modifier la connexion.
Si votre base de données requiert un mot de passe, sélectionnez l'option pour inclure les données sensibles, puis cliquez sur Suivant.
Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.
Développez le nœud Tables dans la page Choisir vos objets de base de données.
Sélectionnez les tables Customers et Orders, puis cliquez sur Terminer.
NorthwindDataSet est ajouté à votre projet et les tables Customers et Orders apparaissent dans la fenêtre Sources de données.
Définition de la colonne CustomerID de la table Orders pour qu'elle utilise le contrôle LookupBox
Dans la fenêtre Sources de données, vous pouvez définir le contrôle à créer avant de faire glisser des éléments vers votre formulaire.
Pour définir la colonne CustomerID pour qu'elle soit liée au contrôle LookupBox
Ouvrez Form1 dans le concepteur.
Développez le nœud Customers dans la fenêtre Sources de données.
Développez le nœud Orders (inclus dans le nœud Customers sous la colonne Fax).
Cliquez sur la flèche déroulante du nœud Orders et choisissez Détails dans la liste de contrôles.
Cliquez sur la flèche déroulante de la colonne CustomerID (dans le nœud Orders) et choisissez Personnaliser.
Sélectionnez LookupBox dans la liste des Contrôles associés de la boîte de dialogue Options de personnalisation de l'interface utilisateur du formulaire de données.
Cliquez sur OK.
Cliquez sur la flèche déroulante de la colonne CustomerID et choisissez LookupBox.
Ajout de contrôles au formulaire
Pour créer des contrôles liés aux données, vous pouvez faire glisser des éléments depuis la fenêtre Sources de données vers Form1.
Pour créer des contrôles liés aux données dans le formulaire Windows
- Faites glisser le nœud Orders de la fenêtre Sources de données vers le formulaire Windows et vérifiez que le contrôle LookupBox est utilisé pour afficher les données dans la colonne CustomerID.
Liaison du contrôle pour rechercher le CompanyName à partir de la table Customers
Pour configurer les liaisons de recherche
Sélectionnez le nœud Customers principal dans la fenêtre Sources de données et faites-le glisser vers la zone de liste déroulante de CustomerIDLookupBox dans Form1.
Cela configure la liaison des données pour afficher le CompanyName dans la table Customers tout en conservant la valeur CustomerID dans la table Orders. Pour plus d'informations, consultez Comment : créer des tables de correspondance dans des applications Windows Forms.
Exécution de l'application
Pour exécuter l'application
Appuyez sur F5 pour exécuter l'application.
Parcourez quelques enregistrements et vérifiez que le CompanyName apparaît dans le contrôle LookupBox.
Voir aussi
Tâches
Concepts
Liaison de contrôles Windows Forms à des données dans Visual Studio
Préparation de votre application pour recevoir des données
Extraction de données dans votre application
Liaison de contrôles à des données dans Visual Studio
Modification des données dans votre application