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.

Retour au début

Voir aussi

Référence

CreateUserWizard