WizardStepBase.AllowReturn Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft einen Wert ab, der angibt, ob der Benutzer von einem nachfolgenden Schritt in einer WizardStepCollection-Auflistung zum aktuellen Schritt zurückkehren kann, oder legt diesen Wert fest.

public:
 virtual property bool AllowReturn { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool AllowReturn { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.AllowReturn : bool with get, set
Public Overridable Property AllowReturn As Boolean

Eigenschaftswert

Boolean

true, wenn der Benutzer zum aktuellen Schritt zurückkehren kann, andernfalls false. Der Standardwert ist true.

Attribute
ThemeableAttribute

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der AllowReturn -Eigenschaft, um zu verhindern, dass der Benutzer zu einem Schritt im Wizard Steuerelement zurückkehrt, nachdem darauf zugegriffen wurde. Im Beispiel ist AllowReturn die -Eigenschaft des Step1 Schritts auf falsefestgelegt. Nachdem der Benutzer den Step1 Schritt verlassen hat, wird keine Schaltfläche Zurück im Step2 Schritt angezeigt.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:Wizard id="Wizard1" 
        runat="server"
    displaysidebar="false" >
        <WizardSteps>
          <asp:WizardStep id="WizardStep1" 
            title="Step 1" 
            allowreturn="false"
            runat="server">
            You are currently on Step 1.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep2" 
            title="Step 2" 
            runat="server">
            You are currently on Step 2.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep3" 
            title="Step 3" 
            runat="server">
            You are currently on Step 3.
          </asp:WizardStep>
        </WizardSteps>
        <HeaderTemplate>
          <b>WizardStepBase AllowReturn Example</b>
        </HeaderTemplate>
      </asp:Wizard>
    </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:Wizard id="Wizard1" 
        runat="server"
    displaysidebar="false" >
        <WizardSteps>
          <asp:WizardStep id="WizardStep1" 
            title="Step 1" 
            allowreturn="false"
            runat="server">
            You are currently on Step 1.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep2" 
            title="Step 2" 
            runat="server">
            You are currently on Step 2.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep3" 
            title="Step 3" 
            runat="server">
            You are currently on Step 3.
          </asp:WizardStep>
        </WizardSteps>
        <HeaderTemplate>
          <b>WizardStepBase AllowReturn Example</b>
        </HeaderTemplate>
      </asp:Wizard>
    </form>
  </body>
</html>

Hinweise

Die AllowReturn -Eigenschaft kann verwendet werden, um die lineare Navigation in einem Wizard Steuerelement zu erzwingen. Wenn die AllowReturn -Eigenschaft für jeden Schritt auf falsefestgelegt ist, kann der Benutzer nach dem Zugriff nicht mehr zu einem Schritt zurückkehren. Ein Szenario, in dem Sie diese Funktionalität verwenden können, besteht darin, einem Benutzer zu verbieten, zu einem Schritt zurückzukehren, nachdem er abgeschlossen wurde, da Sie die Daten nach Abschluss der einzelnen Schritte in einer Datenbank beibehalten. Wenn Sie die Daten nach jedem Schritt speichern und dem Benutzer erlauben, zu einem Schritt zurückzukehren und Informationen zu ändern, nachdem sie gespeichert wurden, werden die gespeicherten Daten möglicherweise beschädigt. Wenn sie die AllowReturn -Eigenschaft auf falsefestlegen, kann der Benutzer, sobald er einen Schritt verlassen hat, nicht zu diesem zurückkehren und keine Werte ändern.

Die AllowReturn -Eigenschaft bestimmt, wie und wann die Schaltfläche Zurück nicht gerendert wird. In der folgenden Tabelle wird das Renderingverhalten der Schaltfläche "Vorherige " beschrieben.

Szenario Verhalten
Linear: Schritt 1 wurde AllowReturn auf false festgelegt, und die Benutzeraktion wechselt zu Schritt 2. In Schritt 2 wird die Schaltfläche Zurück nicht angezeigt.
Nicht linear: Schritt 1 wurde AllowReturn auf false festgelegt, und die Benutzeraktion wechselt zu Schritt 3. In Schritt 3 wird die Schaltfläche Zurück nicht angezeigt.
Seitenleistenschaltflächen: Schritt 2 wurde AllowReturn auf false festgelegt, DisplaySideBar ist auf truefestgelegt, und ein Benutzer klickt auf die Schaltfläche Randleiste. Keine Schaltflächen werden auf der Randleiste automatisch deaktiviert, wenn AllowReturn auf falsefestgelegt ist. Wenn ein Benutzer auf die Schaltfläche klickt, wird die Aktion ignoriert.
Linear & nicht linear mit benutzerdefinierter Vorlage: Der Schritt verfügt über eine benutzerdefinierte Navigationsvorlage. Es erfolgt kein automatisches Ausblenden oder Anzeigen, wenn AllowReturn auf false festgelegt ist, wenn Sie eine Vorlage für die Navigation verwenden. Die Schaltfläche Zurück sollte für die Vorlage optional sein.
Mit dem Visual Studio-Designer und ActiveStepIndex : Das Steuerelement umfasst fünf Schritte, Sie arbeiten an Schritt 4, und Sie führen die Seite aus. Wenn Schritt 4 der ActiveStepIndexist, wird die Schaltfläche Zurück gerendert. Die Schaltfläche Zurück ist nur für StepType festgelegt auf Step ausgeblendet, wenn der vorherige Schritt im Verlauf auf falsefestgelegt wurdeAllowReturn. Da Schritt 4 zuerst gerendert wird und keine Schritte im Verlauf vorhanden sind, ist die Schaltfläche Zurück nicht ausgeblendet.
Startschritt und nicht lineare Navigation: Ein Benutzer besucht Schritt 3 und Schritt 4 und dann Schritt 1, der auf Startfestgelegt istStepType. Der Assistent fügt keine Schaltfläche Zurück hinzu, wenn auf StepTypeStart festgelegt ist, unabhängig davon, wie der Benutzer zu diesem Schritt navigiert.
Derselbe Schritt im Verlauf: Ein Benutzer besucht Schritt 3, in dem StepType auf Step festgelegt ist und der Benutzer seine Aktionen nicht committet. Anschließend klicken sie in Schritt 3 auf die vorherige Schaltfläche. Das Assistentensteuerelement überprüft, ob der vorherige Schritt im Verlauf der "gleiche" Schritt ist, in dem sich der Benutzer gerade befindet. Wenn der Schritt identisch ist, sucht das Assistent-Steuerelement im Verlauf zurück, um den vorherigen "anderen" Schritt zu ermitteln und die Anzeige der Schaltfläche "Zurück " und des Ziels basierend auf dem "anderen Schritt" im Verlauf zu erstellen.

Hinweis

Wenn die AllowReturn -Eigenschaft auf falsefestgelegt ist, die DisplaySideBar -Eigenschaft des übergeordneten Steuerelements von WizardStepBase jedoch auf truefestgelegt ist, hat das Klicken auf eine Schaltfläche im Randleistenbereich keine Auswirkungen. Der Randleistenbereich wird im Allgemeinen angezeigt, um eine nicht lineare Navigation bereitzustellen. Wenn Sie also nicht die Funktionalität der nichtlinearen Navigation verwenden, können Sie die DisplaySideBar -Eigenschaft auf falsefestlegen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen