Freigeben über

Deklarative Syntax des Wizard-Webserver-Steuerelements

Aktualisiert: November 2007

Stellt Navigation und eine Benutzeroberfläche bereit, um verknüpfte Daten in mehreren Schritten erfassen zu können.

<asp:Wizard
    AccessKey="string"
    ActiveStepIndex="integer"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CancelButtonImageUrl="uri"
    CancelButtonText="string"
    CancelButtonType="Button|Image|Link"
    CancelDestinationPageUrl="uri"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DisplayCancelButton="True|False"
    DisplaySideBar="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FinishCompleteButtonImageUrl="uri"
    FinishCompleteButtonText="string"
    FinishCompleteButtonType="Button|Image|Link"
    FinishDestinationPageUrl="uri"
    FinishPreviousButtonImageUrl="uri"
    FinishPreviousButtonText="string"
    FinishPreviousButtonType="Button|Image|Link"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    HeaderText="string"
    Height="size"
    ID="string"
    OnActiveStepChanged="ActiveStepChanged event handler"
    OnCancelButtonClick="CancelButtonClick event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnFinishButtonClick="FinishButtonClick event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnNextButtonClick="NextButtonClick event handler"
    OnPreRender="PreRender event handler"
    OnPreviousButtonClick="PreviousButtonClick event handler"
    OnSideBarButtonClick="SideBarButtonClick event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    SkipLinkText="string"
    StartNextButtonImageUrl="uri"
    StartNextButtonText="string"
    StartNextButtonType="Button|Image|Link"
    StepNextButtonImageUrl="uri"
    StepNextButtonText="string"
    StepNextButtonType="Button|Image|Link"
    StepPreviousButtonImageUrl="uri"
    StepPreviousButtonText="string"
    StepPreviousButtonType="Button|Image|Link"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <CancelButtonStyle />
        <FinishCompleteButtonStyle />
        <FinishNavigationTemplate>
            <!-- child controls -->
        </FinishNavigationTemplate>
        <FinishPreviousButtonStyle />
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <NavigationButtonStyle />
        <NavigationStyle />
        <SideBarButtonStyle />
        <SideBarStyle />
        <SideBarTemplate>
            <!-- child controls -->
        </SideBarTemplate>
        <StartNavigationTemplate>
            <!-- child controls -->
        </StartNavigationTemplate>
        <StartNextButtonStyle />
        <StepNavigationTemplate>
            <!-- child controls -->
        </StepNavigationTemplate>
        <StepNextButtonStyle />
        <StepPreviousButtonStyle />
        <StepStyle />
        <WizardSteps>
                <asp:TemplatedWizardStep
                    AllowReturn="True|False"
                    ContentTemplateContainer="string"
                    EnableTheming="True|False"
                    EnableViewState="True|False"
                    ID="string"
                    OnActivate="Activate event handler"
                    OnDataBinding="DataBinding event handler"
                    OnDeactivate="Deactivate event handler"
                    OnDisposed="Disposed event handler"
                    OnInit="Init event handler"
                    OnLoad="Load event handler"
                    OnPreRender="PreRender event handler"
                    OnUnload="Unload event handler"
                    runat="server"
                    SkinID="string"
                    StepType="Auto|Complete|Finish|Start|Step"
                    Title="string"
                    Visible="True|False"
>
                        <ContentTemplate>
                            <!-- child controls -->
                        </ContentTemplate>
                        <CustomNavigationTemplate>
                            <!-- child controls -->
                        </CustomNavigationTemplate>
                </asp:TemplatedWizardStep>
                <asp:WizardStep
                    AllowReturn="True|False"
                    EnableTheming="True|False"
                    EnableViewState="True|False"
                    ID="string"
                    OnActivate="Activate event handler"
                    OnDataBinding="DataBinding event handler"
                    OnDeactivate="Deactivate event handler"
                    OnDisposed="Disposed event handler"
                    OnInit="Init event handler"
                    OnLoad="Load event handler"
                    OnPreRender="PreRender event handler"
                    OnUnload="Unload event handler"
                    runat="server"
                    SkinID="string"
                    StepType="Auto|Complete|Finish|Start|Step"
                    Title="string"
                    Visible="True|False"
                />
        </WizardSteps>
</asp:Wizard>

Hinweise

Mit dem Wizard-Steuerelement können folgende Aufgaben beendet werden:

  • Erfassen von verknüpften Daten in mehreren Schritten.

  • Aufteilen von größeren Webseiten zum Erfassen von Benutzereingaben in kleinere logische Schritte.

  • Verwenden der linearen oder der nicht-linearen Navigation zum Bearbeiten der Schritte.

Das Wizard-Steuerelement setzt sich aus folgenden Komponenten zusammen:

  • Eine WizardStepCollection-Auflistung von Schritten, die die Benutzeroberfläche für jeden Schritt enthält, wie vom Seitenentwickler festgelegt.

  • Integrierte Navigationsfunktionen, mit denen je nach StepType-Wert die entsprechend anzuzeigenden Schaltflächen bestimmt werden.

  • Ein Headerbereich, der für die Anzeige spezifischer Informationen für den aktuellen Schritt des Benutzers angepasst werden kann.

  • Ein Randleistenbereich, mit dessen Hilfe schnell zu bestimmten Schritten im Steuerelement navigiert werden kann.

Weitere Informationen über das Wizard-Steuerelement finden Sie unter Übersicht über das Wizard-Webserversteuerelement.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie ein Wizard-Steuerelement deklarativ definiert wird. Der Assistent verfügt über zwei Schritte. Die StartNavigationTemplate-Eigenschaftenvorlage und FinishNavigationTemplate-Eigenschaftenvorlage sind definiert.

<asp:Wizard ID="Wizard1" runat="server" ActiveStepIndex="1">
  <WizardSteps>
  <asp:WizardStep ID="WizardStep1" runat="server" Title="Step 1">
  </asp:WizardStep>
  <asp:WizardStep ID="WizardStep2" runat="server" Title="Step 2">
  </asp:WizardStep>
  </WizardSteps>
  <StartNavigationTemplate>
  <asp:Button ID="StartNextButton" runat="server" CommandName="MoveNext" Text="Next" />
  </StartNavigationTemplate>
  <FinishNavigationTemplate>
  <asp:Button ID="FinishPreviousButton" runat="server" CausesValidation="False" CommandName="MovePrevious"
    Text="Previous" />
  <asp:Button ID="FinishButton" runat="server" CommandName="MoveComplete" Text="Finish" />
  </FinishNavigationTemplate>
</asp:Wizard>

<asp:Wizard ID="Wizard1" runat="server" ActiveStepIndex="1">
  <WizardSteps>
  <asp:WizardStep ID="WizardStep1" runat="server" Title="Step 1">
  </asp:WizardStep>
  <asp:WizardStep ID="WizardStep2" runat="server" Title="Step 2">
  </asp:WizardStep>
  </WizardSteps>
  <StartNavigationTemplate>
  <asp:Button ID="StartNextButton" runat="server" CommandName="MoveNext" Text="Next" />
  </StartNavigationTemplate>
  <FinishNavigationTemplate>
  <asp:Button ID="FinishPreviousButton" runat="server" CausesValidation="False" CommandName="MovePrevious"
    Text="Previous" />
  <asp:Button ID="FinishButton" runat="server" CommandName="MoveComplete" Text="Finish" />
  </FinishNavigationTemplate>
</asp:Wizard>

Siehe auch

Referenz

Wizard

Übersicht über das Wizard-Webserversteuerelement

  • Last updated on