Übersicht über das Wizard-Webserversteuerelement
Aktualisiert: November 2007
Mit dem Wizard-Steuerelement können viele der Aufgaben vereinfacht werden, die mit dem Erstellen von Formulargruppen zur Erfassung von Benutzereingaben verbunden sind.
Dieses Thema enthält folgende Abschnitte:
Szenarien
Hintergrund
Codebeispiele
Klassenreferenz
Szenarien
Eine häufig vorkommende Aufgabe bei der Webentwicklung besteht darin, Benutzereingaben mithilfe von Formularen zu erfassen. Eine Gruppe von Formularen zur Erledigung einer bestimmten Aufgabe wird meistens als Assistent bezeichnet.
Das Wizard-Steuerelement in ASP.NET vereinfacht viele der Aufgaben, die mit der Erstellung von mehreren Formularen und der Erfassung von Benutzereingaben verbunden sind. Das Wizard-Steuerelement bietet eine einfache Funktionalität zum Erstellen und Hinzufügen neuer Schritte sowie zum Umordnen bestehender Schritte. Sie können eine lineare oder eine nichtlineare Navigation erstellen und die Benutzerführung des Steuerelements anpassen, ohne Code zu schreiben.
Zurück nach oben
Hintergrund
Um die Datenerfassung zu gliedern, werden normalerweise mehrere zusammenhängende Formulare erstellt. Dies setzt voraus, dass Sie die Navigation zwischen den Formularen, die Datenpersistenz und die Zustandsverwaltung in den einzelnen Schritten regeln. Mit dem Wizard-Steuerelement können Sie die Datenerfassung in verschiedene Schritte gliedern, zwischen denen navigiert werden kann. Dadurch wird die Benutzerfreundlichkeit erhöht. Als Entwickler müssen Sie sich keine Gedanken über die Datenpersistenz machen, da das Steuerelement den Status während der verschiedenen Schritte beibehält.
Assistentenschritte
Beim Wizard-Steuerelement werden mehrere Schritte durchlaufen, um die verschiedenen Abschnitte der Dateneingabe voneinander abzugrenzen. Für die Schritte des Steuerelements wird durch die StepType-Eigenschaft angegeben, ob es sich um einen Anfangs-, Zwischen- oder Abschlussschritt handelt. Der Assistent kann über beliebig viele Zwischenschritte verfügen. Sie können zur Erfassung von Benutzereingaben verschiedene Steuerelemente hinzufügen, wie etwa das TextBox-Steuerelement oder das ListBox-Steuerelement. Wenn Sie den Complete-Schritt erreichen, sind alle Daten zugänglich. Das folgende Codebeispiel veranschaulicht die Verwendung des Wizard-Steuerelements mit zwei Schritten.
<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>
In jedem Schritt können Sie Steuerelemente und Beschriftungen hinzufügen sowie Benutzerdaten aufnehmen. Mithilfe des Wizard-Steuerelements können Sie bestimmen, welcher Schritt angezeigt werden soll, und Sie können die erfassten Daten verwalten.
Assistentennavigation
Das Wizard-Steuerelement unterstützt sowohl lineare als auch nichtlineare Navigation. Mit der Zustandsverwaltung des Steuerelements können sich die Benutzer zwischen den Schritten hin- und herbewegen sowie jederzeit einen beliebigen Schritt auswählen, sofern die Randleiste angezeigt wird. Den Text für die Navigation können Sie im asp:Wizard-Wurzelelement des Steuerelements anpassen, und zwar mithilfe der StepNextButtonText-Eigenschaft, der StepPreviousButtonText-Eigenschaft und der FinishCompleteButtonText-Eigenschaft.
<asp:Wizard ID="Wizard1" Runat="server"
StepNextButtonText=" Next >> "
StepPreviousButtonText=" << Previous "
FinishCompleteButtonText=" Done! ">
Anpassen anderer Aspekte des Wizard-Steuerelements
Das Wizard-Steuerelement zeigt automatisch einen Titel und den aktuellen Schritt an. Der Titel wird mithilfe der HeaderText-Eigenschaft angepasst. Die Headervorlage können Sie mithilfe der HeaderTemplate-Eigenschaft anpassen.
Optional können Sie eine Schaltfläche zum Abbrechen anzeigen, indem Sie die DisplayCancelButton-Eigenschaft auf true festlegen.
Das Wizard-Steuerelement bietet mit der NavigationButtonStyle-Eigenschaft eine einfache Möglichkeit, das Format aller Schaltflächen einheitlich festzulegen. Die Flexibilität, jede Schaltfläche einzeln anzupassen, bleibt dabei erhalten. Die NavigationButtonStyle-Eigenschaft gilt für alle Schaltflächen, die gerendert werden. Sie können dieses Format jedoch überschreiben, indem Sie die Formateigenschaft der einzelnen Schaltflächen festlegen.
Navigationsvorlagen
Das Wizard-Steuerelement unterstützt Vorlagen, mit denen Sie die Schnittstelle weiter anpassen können. Dies erfolgt mithilfe der StartNavigationTemplate-Eigenschaft, der FinishNavigationTemplate-Eigenschaft, der StepNavigationTemplate-Eigenschaft und der SideBarTemplate-Eigenschaft.
Ereignisse des Wizard-Steuerelements
Sie können das Verhalten des Wizard-Steuerelements mithilfe von benutzerdefiniertem Code und benutzerdefinierten Ereignissen anpassen.
Zum Beispiel können Sie das NextButtonClick-Ereignis abfangen, das bei einem Klicken auf die Schaltfläche Weiter ausgelöst wird und die Daten des aktuellen Schrittes aufzeichnet. Der WizardNavigationEventArgs-Parameter, der diesem Ereignis übergeben wird, enthält die CurrentStepIndex-Eigenschaft und die NextStepIndex-Eigenschaft. Mit diesen Eigenschaften können Sie das Verhalten des Steuerelements dem aktuellen und den folgenden Schritten entsprechend anpassen oder die Navigation abbrechen, wenn auf die Schaltfläche Weiter geklickt wird.
Auf ähnliche Weise können Sie das Verhalten der Schaltflächen Zurück und Fertig stellen anpassen. Verwenden Sie dazu das PreviousButtonClick-Ereignis und das FinishButtonClick-Ereignis. Sie können außerdem eine Bereinigung durchführen, wenn auf die Schaltfläche Abbrechen geklickt wird. Verwenden Sie hierzu das CancelButtonClick-Ereignis.
Zurück nach oben
Codebeispiele
Exemplarische Vorgehensweise: Erstellen eines einfachen ASP.NET-Wizard-Steuerelements
Exemplarische Vorgehensweise: Erweiterte Verwendung des ASP.NET-Wizard-Steuerelements
Zurück nach oben
Klassenreferenz
Die folgenden Tabelle enthält die Hauptklassen, die sich auf das Wizard-Steuerelement beziehen.
Member |
Beschreibung |
|---|---|
Die Hauptklasse des Steuerelements. |
|
Stellt die Daten bereit, die für die verschiedenen Navigationsereignisse in einem Wizard-Steuerelement benötigt werden. |
|
Stellt die Methode dar, die die Navigationsereignisse in einem Wizard-Steuerelement behandelt. |
|
Stellt einen grundlegenden Schritt dar, der in einem Wizard-Steuerelement angezeigt wird. |
|
Stellt eine Auflistung von WizardStep-Objekten dar, die die Benutzeroberfläche für jeden Schritt enthalten, entsprechend der Festlegung durch den Seitenentwickler. |
|
Legt die Typen der Navigationsbenutzeroberfläche fest, die für einen Schritt in einem Wizard-Steuerelement angezeigt werden können. |
Zurück nach oben