Vue d’ensemble du contrôle utilisateur (Windows Forms .NET)

Un contrôle utilisateur est une collection de contrôles Windows Forms encapsulés dans un conteneur commun. Ce type de contrôle est appelé contrôle composite. Les contrôles contenus sont appelés contrôles constitutifs. Les contrôles utilisateur dérivent de la UserControl classe.

Les contrôles utilisateur sont conçus comme Forms, avec un concepteur visuel. Vous créez, organisez et modifiez les contrôles constituants via le concepteur visuel. Les événements de contrôle et la logique sont écrits exactement de la même façon que lorsque vous concevez un formulaire. Le contrôle utilisateur est placé sur un formulaire comme n’importe quel autre contrôle.

Les contrôles utilisateur sont utilisables par le projet dans lequel ils sont créés ou dans d’autres projets qui ont une référence à la bibliothèque du contrôle utilisateur.

Important

La documentation du Guide du bureau pour .NET 7 et .NET 6 est en cours de construction.

Contrôles constituants

Les contrôles constituants sont disponibles pour le contrôle utilisateur et l’utilisateur de l’application peut interagir avec eux individuellement au moment de l’exécution, mais les propriétés et méthodes déclarées par les contrôles constituants ne sont pas exposées au consommateur. Par exemple, si vous placez un TextBox contrôle et Button un contrôle sur le contrôle utilisateur, l’événement du Click bouton est géré en interne par le contrôle utilisateur, mais pas par le formulaire où le contrôle utilisateur est placé.

Ajouter un contrôle utilisateur à un projet

Après avoir créé un projet, utilisez les modèles Visual Studio pour créer un contrôle utilisateur. Les étapes suivantes montrent comment ajouter un contrôle utilisateur à votre projet :

1. Dans Visual Studio, recherchez le volet Explorateur de projets. Cliquez avec le bouton droit sur le projet et choisissez Ajouter un>contrôle utilisateur (Windows Forms).

   

2. Dans la zone Nom , tapez un nom pour votre contrôle utilisateur. Visual Studio fournit un nom par défaut et unique que vous pouvez utiliser. Ensuite, appuyez sur Ajouter.

   

Une fois le contrôle utilisateur créé, Visual Studio ouvre le concepteur :

Pour obtenir un exemple de contrôle utilisateur fonctionnel, consultez Comment créer un contrôle utilisateur.