Vue d'ensemble du contrôle serveur Web Wizard
Mise à jour : novembre 2007
Utilisez le contrôle Wizard qui simplifie un grand nombre des tâches associées à la génération d'une série de formulaires servant à recueillir les entrées d'utilisateur.
Cette rubrique contient les sections suivantes :
Scénarios
Contexte
Exemples de code
Référence de classe
Scénarios
La collecte d'entrées d'utilisateur à l'aide de formulaires est une tâche récurrente du développement Web. Une série de formulaires utilisée pour réaliser une tâche est souvent appelée Assistant.
Le contrôle Wizard ASP.NET simplifie un grand nombre des tâches associées à la génération de plusieurs formulaires et à la collecte des entrées d'utilisateur. Le contrôle Wizard fournit un mécanisme simple qui vous permet de créer facilement des étapes, d'en ajouter ou de les réorganiser. Vous pouvez concevoir une navigation linéaire et non linéaire ainsi que personnaliser la navigation utilisateur du contrôle sans écrire de code.
Retour au début
Contexte
Il est courant de créer une série de formulaires interconnectés pour décomposer la collecte de données. Vous pouvez effectuer cette opération en gérant la navigation entre les formulaires, la persistance des données et la gestion d'état à chaque étape. Avec le contrôle Wizard, vous utilisez des étapes distinctes pour recueillir les données, ce qui permet aux utilisateurs de naviguer à leur guise entre les étapes et leur facilite ainsi la tâche. En tant que développeur, vous n'avez pas à vous soucier de la persistance de vos données entre les pages parce que le contrôle maintient l'état pendant que l'utilisateur exécute les diverses étapes.
Étapes de l'Assistant
Le contrôle Wizard utilise des étapes pour distinguer les différentes sections des entrées de données d'utilisateur. Chaque étape du contrôle prend une valeur StepType qui indique s'il s'agit de la première étape, d'une étape intermédiaire ou de la dernière étape. L'Assistant peut comporter autant d'étapes intermédiaires que nécessaire. Vous pouvez ajouter divers contrôles, tels que TextBox ou ListBox, pour recueillir les entrées d'utilisateur. Lorsque vous parvenez à l'étape Complete, toutes vos données sont accessibles. L'exemple de code suivant illustre le contrôle Wizard avec deux étapes.
<asp:Wizard ID="Wizard1" Runat="server">
<WizardSteps>
<asp:WizardStep Runat="server" Title="Step 1">
</asp:WizardStep>
<asp:WizardStep Runat="server" Title="Step 2">
</asp:WizardStep>
</WizardSteps>
</asp:Wizard>
Dans chaque étape, vous pouvez ajouter des contrôles et des étiquettes et accepter des données d'utilisateur. Le contrôle Wizard permet de contrôler l'étape à afficher et de tenir à jour les données recueillies.
Navigation dans l'Assistant
Le contrôle Wizard autorise une navigation linéaire et non linéaire. La gestion d'état du contrôle permet à l'utilisateur de faire défiler les étapes dans un sens ou dans l'autre, ainsi que de sélectionner à tout moment des étapes individuelles, tant que la barre latérale est affichée. Vous pouvez personnaliser le texte pour la navigation dans l'élément asp:Wizard racine du contrôle en utilisant les propriétés StepNextButtonText, StepPreviousButtonText et FinishCompleteButtonText.
<asp:Wizard ID="Wizard1" Runat="server"
StepNextButtonText=" Next >> "
StepPreviousButtonText=" << Previous "
FinishCompleteButtonText=" Done! ">
Personnalisation d'autres aspects du contrôle Wizard
Le contrôle Wizard affiche automatiquement un titre et l'étape actuelle. Le titre est personnalisé avec la propriété HeaderText. Vous pouvez ajuster le modèle de l'en-tête en utilisant la propriété HeaderTemplate.
Vous pouvez afficher éventuellement un bouton d'annulation en affectant à la propriété DisplayCancelButton la valeur true.
La propriété NavigationButtonStyle du contrôle Wizard permet d'affecter facilement un style commun à tous les boutons, tout en offrant la souplesse nécessaire pour personnaliser chaque bouton individuellement. La propriété NavigationButtonStyle s'applique à tous les boutons rendus. Toutefois, vous pouvez substituer ce style en définissant la propriété de style de chaque bouton.
Modèles de navigation
Le contrôle Wizard prend en charge des modèles qui vous permettent de personnaliser encore plus l'interface du contrôle avec les propriétés StartNavigationTemplate, FinishNavigationTemplate, StepNavigationTemplate et SideBarTemplate.
Événements du contrôle Wizard
Vous pouvez personnaliser le comportement du contrôle Wizard en utilisant du code et des événements personnalisés.
Par exemple, vous pouvez intercepter l'événement NextButtonClick qui est déclenché lorsque l'utilisateur clique sur le bouton Suivant et capture les données de l'étape actuelle. Le paramètre WizardNavigationEventArgs passé à cet événement inclut les propriétés CurrentStepIndex et NextStepIndex, vous permettant de personnaliser le comportement du contrôle selon les étapes actuelle et suivante, ou d'annuler la navigation lorsque l'utilisateur clique sur le bouton Suivant.
De même, vous pouvez personnaliser le comportement des boutons Précédent et Terminer en utilisant les événements PreviousButtonClick et FinishButtonClick. Vous pouvez aussi effectuer un nettoyage lorsque l'utilisateur clique sur le bouton Annuler, en utilisant l'événement CancelButtonClick.
Retour au début
Exemples de code
Procédure pas à pas : création d'un contrôle Wizard ASP.NET de base
Procédure pas à pas : utilisation avancée du contrôle Wizard ASP.NET
Retour au début
Référence de classe
Le tableau suivant répertorie les classes clés relatives au contrôle Wizard.
Membre |
Description |
|---|---|
Classe principale du contrôle. |
|
Fournit les données nécessaires pour les différents événements de navigation dans un contrôle Wizard. |
|
Représente la méthode qui gérera les événements de navigation d'un contrôle Wizard. |
|
Représente une étape fondamentale qui est affichée dans un contrôle Wizard. |
|
Représente une collection d'objets WizardStep qui contient l'interface utilisateur pour chaque étape, comme défini par le développeur de pages. |
|
Spécifie les types d'interfaces utilisateur de navigation pouvant s'afficher pour une étape dans un contrôle Wizard. |
Retour au début