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 für den Step1 Schritt 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 für jeden Schritt seine AllowReturn Eigenschaft auf falsefestgelegt ist, kann der Benutzer nach dem Zugriff nicht 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 jedes Schritts 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 er gespeichert wurde, werden die gespeicherten Daten möglicherweise beschädigt. Wenn die AllowReturn -Eigenschaft auf falsefestgelegt wird, kann der Benutzer nach dem Verlassen eines Schritts 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 geht 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 geht 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 Seitenleiste. Keine Schaltflächen werden automatisch auf der Seitenleiste 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.
Verwenden von Visual Studio Designer und ActiveStepIndex : Das Steuerelement umfasst 5 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 wird nur ausgeblendet StepTypeStep, wenn der vorherige Schritt im Verlauf auf falsefestgelegt wurdeAllowReturn. Da Schritt 4 zuerst gerendert wird und keine Schritte im Verlauf vorhanden sind, wird die Schaltfläche Zurück nicht ausgeblendet.
Schritt und nicht lineare Navigation starten: Ein Benutzer besucht Schritt 3 und Schritt 4 und dann Schritt 1, der auf Startfestgelegt hatStepType. Der Assistent fügt keine Schaltfläche Zurück hinzu, wenn auf festgelegt StepTypeStart ist, unabhängig davon, wie der Benutzer zu diesem Schritt navigiert.
Gleicher 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 Steuerelement des Assistenten überprüft, ob der vorherige Schritt im Verlauf der "gleiche" Schritt ist, in dem sich der Benutzer gerade befindet. Wenn der Schritt identisch ist, sieht das Assistentensteuerelement im Verlauf zurück, um den vorherigen "anderen" Schritt zu bestimmen 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, aber die DisplaySideBar Eigenschaft des übergeordneten Steuerelements von WizardStepBase auf truefestgelegt ist, hat das Klicken auf eine Schaltfläche im Randleistenbereich keine Auswirkung. Der Randleistenbereich wird im Allgemeinen angezeigt, um eine nichtlineare Navigation bereitzustellen. Wenn Sie also die Funktionalität der nichtlinearen Navigation nicht 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