Freigeben über

WizardStepBase.AllowReturn Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer aus einem nachfolgenden Schritt in einer WizardStepCollection Auflistung zum aktuellen Schritt zurückkehren darf.

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

truewenn der Benutzer zum aktuellen Schritt zurückkehren darf; 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 der Step1 Schritt auf seine AllowReturnfalseEigenschaft festgelegt. Nachdem der Benutzer den Step1 Schritt verlassen hat, wird im Schritt keine Schaltfläche "Zurück" angezeigt Step2 .

<%@ 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 die AllowReturn Eigenschaft festgelegt falseist, 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 in einer Datenbank beibehalten, sobald jeder Schritt abgeschlossen ist. Wenn Sie die Daten nach jedem Schritt speichern und dem Benutzer erlauben, zu einem Schritt zurückzukehren und Informationen nach dem Speichern zu ändern, werden die gespeicherten Daten möglicherweise beschädigt. Wenn Sie die AllowReturn Eigenschaft auf false", nachdem der Benutzer einen Schritt verlassen hat, können sie nicht mehr dorthin zurückkehren und 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 vorherigen Schaltfläche beschrieben.

Szenario Verhalten
Linear: Schritt1 wurde AllowReturn auf Schritt 2 festgelegt, und die Benutzeraktion wird auf Schritt 2 gesetzt false . In Schritt 2 wird die Schaltfläche "Zurück " nicht angezeigt.
Nicht linear: Schritt1 wurde AllowReturn auf Schritt 3 festgelegt, und die Benutzeraktion wird auf Schritt 3 gesetzt false . Schritt 3 zeigt die Schaltfläche "Zurück " nicht an.
Randleistenschaltflächen: Schritt 2 ist AllowReturn auf " DisplaySideBar festgelegt" festgelegt truefalse , und ein Benutzer klickt auf die Schaltfläche "Randleiste". Es werden keine Schaltflächen automatisch auf der Randleiste deaktiviert, wenn sie auf .a0> festgelegt ist. Wenn ein Benutzer auf die Schaltfläche klickt, wird die Aktion ignoriert.
Linear und nicht linear mit benutzerdefinierter Vorlage: Der Schritt verfügt über eine benutzerdefinierte Navigationsvorlage. Wenn beim Verwenden einer Vorlage für die Navigation eine Vorlage verwendet false wird, AllowReturn tritt kein automatisches Ausblenden oder Anzeigen auf. Die Schaltfläche "Zurück " sollte für die Vorlage optional sein.
Mit dem Visual Studio-Designer und ActiveStepIndex : Das Steuerelement verfügt über fünf Schritte, Sie arbeiten an Schritt 4, und Führen Sie die Seite aus. Wenn Schritt 4 ist ActiveStepIndex, wird die Schaltfläche "Zurück " gerendert. Die Schaltfläche "Zurück " ist nur ausgeblendet, StepTypeStep wenn der vorherige Schritt im Verlauf AllowReturn auf " false. Da Schritt 4 zuerst gerendert wird und es keine Schritte im Verlauf gibt, ist die Schaltfläche "Zurück " nicht ausgeblendet.
Starten Sie Schritt und nicht lineare Navigation: Ein Benutzer besucht Schritt 3 und Schritt 4 und dann Schritt 1, der StepType auf Start Der Assistent fügt keine Schaltfläche "Zurück " hinzu, wenn die StepType Einstellung unabhängig davon erfolgt Start , wie der Benutzer zu diesem Schritt navigiert.
Derselbe Schritt im Verlauf: Ein Benutzer besucht Schritt 3, auf den StepType festgelegt Step ist und der Benutzer seine Aktionen nicht übernimmt. Sie klicken dann auf die vorherige Schaltfläche in Schritt 3. Das Steuerelement des Assistenten überprüft, ob der vorherige Schritt im Verlauf der "gleiche" Schritt ist, auf dem sich der Benutzer gerade befindet. Wenn der Schritt identisch ist, sieht das Assistentensteuerelement 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 bestimmen.

Hinweis

Wenn die AllowReturn Eigenschaft auf false" festgelegt ist, aber die DisplaySideBar Eigenschaft des übergeordneten Steuerelements WizardStepBase auf " festgelegt trueist , hat das Klicken auf eine Schaltfläche im Randleistenbereich keine Auswirkung. Der Randleistenbereich wird in der Regel angezeigt, um nichtlineare Navigation bereitzustellen. Wenn Sie also nicht die Funktionalität der nichtlinearen Navigation verwenden, sollten Sie die DisplaySideBar Eigenschaft falseauf festlegen.

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