Sviluppo di un'interfaccia utente per un enumeratore Foreach personalizzatoDeveloping a User Interface for a Custom ForEach Enumerator

Dopo avere eseguito l'override dell'implementazione delle proprietà e dei metodi della classe di base per fornire la funzionalità personalizzata, è possibile creare un'interfaccia utente personalizzata per l'enumeratore Foreach.After you have overridden the implementation of the properties and methods of the base class to provide your custom functionality, you may want to create a custom user interface for your Foreach enumerator. Se non si crea un'interfaccia utente personalizzata, gli utenti possono configurare il nuovo enumeratore ForEach solo utilizzando la finestra delle proprietà.If you do not create a custom user interface, users can only configure the new custom Foreach enumerator by using the Properties window.

In un progetto o assembly di interfaccia utente personalizzata, creare una classe che implementa ForEachEnumeratorUI.In a custom user interface project or assembly, you create a class that implements ForEachEnumeratorUI. Questa classe deriva da UserControl, in genere utilizzato per creare un controllo composito per ospitare altri controlli Windows Form.This class derives from System.Windows.Forms.UserControl, which is typically used to create a composite control to host other Windows Forms controls. Il controllo creato viene visualizzato nel configurazione enumeratore area della raccolta scheda della finestra il Editor ciclo Foreach.The control that you create is displayed in the Enumerator configuration area of the Collection tab of the Foreach Loop Editor.

Importante

Dopo la firma e la creazione di un'interfaccia utente personalizzata e installarlo nella global assembly cache, come descritto in compilazione, distribuzione e debug di oggetti personalizzati, ricordarsi di specificare il nome completo di questa classe nella UITypeName proprietà del DtsForEachEnumeratorAttribute.After signing and building your custom user interface and installing it in the global assembly cache as described in Building, Deploying, and Debugging Custom Objects, remember to provide the fully qualified name of this class in the UITypeName property of the DtsForEachEnumeratorAttribute.

Scrittura del codice della classe del controllo interfaccia utenteCoding the User Interface Control Class

Inizializzazione dell'interfaccia utenteInitializing the User Interface

Eseguire l'override del metodo Initialize per memorizzare nella cache i riferimenti all'oggetto host e alle raccolte di gestioni connessioni e variabili definite nel pacchetto.You override the Initialize method to cache references to the host object, and to the collections of connection managers and variables defined in the package.

Impostazione di proprietà sul controllo interfaccia utenteSetting Properties on the User Interface Control

La classe UserControl, da cui deriva la classe dell'interfaccia utente, deve essere utilizzato come un controllo composito per ospitare altri controlli Windows Form.The UserControl class, from which the user interface class is derived, is intended for use as a composite control to host other Windows Forms controls. Poiché questa classe ospita altri controlli, è possibile progettare l'interfaccia utente personalizzata trascinando e rilasciando controlli, disponendoli, impostando le relative proprietà e rispondendo in fase di esecuzione agli eventi in qualsiasi applicazione Windows Form.Because this class hosts other controls, you can design your custom user interface by dragging and dropping controls, arranging them, setting their properties, and responding at run time to their events as in any Windows Forms application.

Salvataggio delle impostazioniSaving Settings

Eseguire l'override del metodo SaveSettings per copiare i valori selezionati dall'utente dai controlli nelle proprietà dell'enumeratore quando l'utente chiude l'editor.You override the SaveSettings method to copy the values selected by the user from the controls to the properties of the enumerator when the user closes the editor.

Vedere ancheSee Also

Creazione di un enumeratore Foreach personalizzato Creating a Custom Foreach Enumerator
Codifica un enumeratore Foreach personalizzatoCoding a Custom Foreach Enumerator