Développement d'une interface utilisateur pour un énumérateur ForEach personnalisé

S’applique à : SQL Server SSIS Integration Runtime dans Azure Data Factory

Après avoir remplacé l'implémentation des propriétés et méthodes de la classe de base afin de fournir vos fonctionnalités personnalisées, vous pouvez créer une interface utilisateur personnalisée pour votre énumérateur Foreach. Si vous ne créez pas d'interface utilisateur personnalisée, les utilisateurs peuvent configurer uniquement le nouvel énumérateur Foreach personnalisé en utilisant la fenêtre Propriétés.

Dans un projet ou assembly d'interface utilisateur personnalisée, vous créez une classe qui implémente l'objet ForEachEnumeratorUI. Cette classe provient de System.Windows.Forms.UserControl, qui est généralement utilisé pour créer un contrôle composite afin d’héberger d’autres contrôles Windows Forms. Le contrôle que vous créez s’affiche sous l’onglet Collection de l’Éditeur de boucle Foreach, dans la zone Configuration de l’énumérateur.

Important

Après avoir signé et généré votre interface utilisateur personnalisée, puis l’avoir installée dans le Global Assembly Cache comme décrit dans Génération, déploiement et débogage d’objets personnalisés, n’oubliez pas de fournir le nom complet de cette classe dans la propriété UITypeName de la classeDtsForEachEnumeratorAttribute.

Codage de la classe de contrôle de l'interface utilisateur

Initialisation de l'interface utilisateur

Vous remplacez la méthode Initialize pour mettre en cache des références à l'objet hôte et aux collections de gestionnaires de connexion et variables définies dans le package.

Définition de propriétés sur le contrôle de l'interface utilisateur

La classe UserControl, de laquelle provient la classe de l’interface utilisateur, est destinée à être utilisée comme contrôle composite afin d’héberger d’autres contrôles Windows Forms. Parce que cette classe héberge d'autres contrôles, vous pouvez concevoir votre interface utilisateur personnalisée en faisant glisser des contrôles, en les réorganisant, en définissant leurs propriétés et en répondant au moment de l'exécution à leurs événements comme dans toute application Windows Forms.

Enregistrement des paramètres

Vous remplacez la méthode SaveSettings pour copier les valeurs sélectionnées par l'utilisateur depuis les contrôles vers les propriétés de l'énumérateur lorsque l'utilisateur ferme l'éditeur.

Voir aussi

Création d'un énumérateur Foreach personnalisé
Codage d'un énumérateur Foreach personnalisé