Cenni preliminari sul controllo server Web Wizard
Aggiornamento: novembre 2007
Utilizzare il controllo Wizard che consente di semplificare molte attività associate alla compilazione di una serie di form per l'insieme dell'input dell'utente.
Vengono illustrati i seguenti argomenti:
Scenari
Background
Esempi di codice
Riferimento alle classi
Scenari
L'insieme dell'input dell'utente tramite l'utilizzo di form è un'attività ricorrente nello sviluppo Web. Il gruppo di form utilizzato per eseguire un'attività è spesso definito procedura guidata.
Il controllo ASP.NET Wizard semplifica numerose attività associate alla generazione di più form e all'insieme dell'input dell'utente. Mediante il controllo Wizard è possibile generare passaggi, aggiungerne di nuovi o riordinare quelli esistenti in modo semplice e immediato. È inoltre possibile generare spostamenti lineari e non lineari, nonché personalizzare gli spostamenti dell'utente tra i controlli senza scrivere alcuna riga di codice.
Torna all'inizio
Background
La generazione di una serie di form interconnessi per suddividere l'insieme dei dati è una tecnica diffusa. A questo scopo è necessario gestire gli spostamenti tra i form, la persistenza dei dati e il mantenimento dello stato per ogni singolo passaggio. Con il controllo Wizard è possibile utilizzare passaggi distinti per l'insieme dei dati. Gli utenti possono così spostarsi da un passaggio all'altro a loro discrezione e con più facilità. Lo sviluppatore non deve preoccuparsi della persistenza dei dati tra le pagine perché lo stato del controllo viene mantenuto mentre l'utente esegue i vari passaggi.
Passaggi della procedura guidata
Il controllo Wizard utilizza più passaggi per delineare le diverse sezioni dell'input di dati da parte dell'utente. A ogni passaggio all'interno del controllo viene assegnato uno StepType per indicare se si tratta del passaggio iniziale, di uno intermedio o di quello finale. Il numero di passaggi intermedi della procedura guidata non è soggetto a limiti. Per l'insieme dell'input dell'utente è possibile aggiungere controlli differenti, ad esempio TextBox o ListBox. Quando viene raggiunto il passaggio Complete, tutti i dati sono accessibili. Nell'esempio di codice riportato di seguito viene illustrato un controllo Wizard con due passaggi.
<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>
All'interno di ogni passaggio è possibile aggiungere controlli ed etichette e accettare dati dell'utente. Il controllo Wizard faciliterà la gestione dei passaggi da visualizzare e il mantenimento dei dati raccolti.
Spostamenti all'interno della procedura guidata
Il controllo Wizard supporta spostamenti di tipo sia lineare che non lineare. La gestione dello stato del controllo consente all'utente di spostarsi avanti e indietro tra i passaggi, nonché di selezionare singoli passaggi da qualsiasi punto della procedura, purché sia visualizzata l'intestazione laterale. È possibile personalizzare il testo per gli spostamenti nell'elemento asp:Wizard di primo livello del controllo utilizzando le proprietà StepNextButtonText, StepPreviousButtonText e FinishCompleteButtonText.
<asp:Wizard ID="Wizard1" Runat="server"
StepNextButtonText=" Next >> "
StepPreviousButtonText=" << Previous "
FinishCompleteButtonText=" Done! ">
Personalizzazione di altri aspetti del controllo Wizard
Il controllo Wizard visualizza automaticamente un titolo e il passaggio corrente. Il titolo viene personalizzato tramite la proprietà HeaderText. È possibile modificare il modello dell'intestazione mediante la proprietà HeaderTemplate.
È anche possibile visualizzare un pulsante di annullamento impostando la proprietà DisplayCancelButton su true.
Mediante la proprietà NavigationButtonStyle del controllo Wizard è possibile impostare agevolmente uno stile comune per tutti i pulsanti o personalizzare i singoli pulsanti. La proprietà NavigationButtonStyle viene applicata a tutti i pulsanti di cui viene eseguito il rendering. È tuttavia possibile eseguire l'override di questo stile impostando la proprietà dello stile per un singolo pulsante.
Modelli di spostamento
Il controllo Wizard supporta modelli che ne consentono l'ulteriore personalizzazione dell'interfaccia tramite le proprietà StartNavigationTemplate, FinishNavigationTemplate, StepNavigationTemplate e SideBarTemplate.
Eventi generati dal controllo Wizard
È possibile personalizzare il comportamento del controllo Wizard mediante codice ed eventi personalizzati.
È ad esempio possibile intercettare l'evento NextButtonClick, che viene generato quando l'utente fa clic sul pulsante Avanti e acquisisce i dati del passaggio corrente. Il parametro WizardNavigationEventArgs passato a questo evento include le proprietà CurrentStepIndex e NextStepIndex, che consentono di personalizzare il comportamento del controllo in base al passaggio corrente e a quello successivo oppure di annullare lo spostamento quando viene fatto clic sul pulsante Avanti.
Analogamente, è possibile personalizzare il comportamento dei pulsanti Indietro e Fine mediante gli eventi PreviousButtonClick e FinishButtonClick. È inoltre possibile utilizzare l'evento CancelButtonClick per ottenere la cancellazione di tutti i dati precedentemente immessi dall'utente quando questi fa clic sul pulsante Annulla.
Torna all'inizio
Esempi di codice
Procedura dettagliata: creazione di un controllo Wizard ASP.NET di base
Procedura dettagliata: utilizzo avanzato del controllo Wizard ASP.NET
Torna all'inizio
Riferimento alle classi
Nella tabella riportata di seguito sono elencate le classi principali correlate al controllo Wizard.
Membro |
Descrizione |
|---|---|
La classe principale per il controllo. |
|
Vengono forniti i dati necessari per i vari eventi di spostamento in un controllo Wizard. |
|
Rappresenta il metodo che gestirà gli eventi di spostamento in un controllo Wizard. |
|
Rappresenta un passaggio di base visualizzato in un controllo Wizard. |
|
Rappresenta un insieme di oggetti WizardStep che contengono l'interfaccia utente di ciascun passaggio, come definito dallo sviluppatore della pagina. |
|
Specifica gli elementi di spostamento dell'interfaccia utente che possono essere visualizzati per un passaggio in un controllo Wizard. |
Torna all'inizio