WizardStepBase.AllowReturn Eigenschap

Definitie

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

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebruiker vanuit een volgende stap in een WizardStepCollection verzameling mag terugkeren naar de huidige stap.

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

Waarde van eigenschap

Boolean

true als de gebruiker mag terugkeren naar de huidige stap; anders, false. De standaardwaarde is true.

Kenmerken
ThemeableAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u de AllowReturn eigenschap gebruikt om te voorkomen dat de gebruiker terugkeert naar een stap in het Wizard besturingselement nadat het is geopend. In het voorbeeld is AllowReturn de eigenschap van de Step1 stap ingesteld op false. Nadat de gebruiker de Step1 stap heeft verlaten, wordt er geen knop Vorige weergegeven in de Step2 stap.

<%@ 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>

Opmerkingen

De AllowReturn eigenschap kan worden gebruikt om lineaire navigatie in een Wizard besturingselement af te dwingen. Als voor elke stap de eigenschap is AllowReturn ingesteld false, kan de gebruiker niet terugkeren naar een stap nadat deze is geopend. Een scenario waarin u deze functionaliteit kunt gebruiken, is het niet toegestaan dat een gebruiker teruggaat naar een stap nadat deze is voltooid, omdat u de gegevens ophoudt in een database wanneer elke stap is voltooid. Als u de gegevens na elke stap opslaat en de gebruiker toestaat terug te keren naar een stap en informatie te wijzigen nadat deze is opgeslagen, kunnen de opgeslagen gegevens beschadigd raken. Door de AllowReturn eigenschap in te stellen op false, zodra de gebruiker een stap heeft verlaten, kunnen ze er niet meer naar terugkeren en waarden wijzigen.

De AllowReturn eigenschap bepaalt hoe en wanneer de knop Vorige niet wordt weergegeven. In de volgende tabel wordt het gedrag van de vorige knopweergave beschreven.

Scenario Gedrag
Lineair: Stap1 is AllowReturn ingesteld op false en gebruikersactie gaat naar stap 2. In stap 2 wordt de knop Vorige niet weergegeven.
Niet-lineair: Stap1 is AllowReturn ingesteld op false en gebruikersactie gaat naar stap 3. In stap 3 wordt de knop Vorige niet weergegeven.
Zijbalkknoppen: Stap 2 is AllowReturn ingesteld op false , DisplaySideBar is ingesteld trueop en een gebruiker klikt op de knop Zijbalk. Er worden geen knoppen automatisch uitgeschakeld op de zijbalk wanneer AllowReturn deze is ingesteld op false. Als een gebruiker op de knop klikt, wordt de actie genegeerd.
Lineair en niet-lineair met aangepaste sjabloon: de stap heeft een aangepaste navigatiesjabloon. Automatisch verbergen of weergeven gebeurt niet als AllowReturn deze is ingesteld false op wanneer u een sjabloon gebruikt voor navigatie. De knop Vorige moet optioneel zijn op de sjabloon.
Met behulp van de Visual Studio Designer en ActiveStepIndex: het besturingselement heeft vijf stappen, u werkt aan stap 4 en u voert de pagina uit. Wanneer stap 4 de ActiveStepIndexknop Vorige is, wordt de knop Vorige weergegeven. De knop Vorige is alleen verborgen als StepTypeStep de vorige stap in de geschiedenis is AllowReturn ingesteld op false. Omdat stap 4 eerst wordt weergegeven en er geen stappen in de geschiedenis staan, is de knop Vorige niet verborgen.
Beginstap en niet-lineaire navigatie: een gebruiker bezoekt stap 3 en stap 4 en vervolgens stap 1 die is StepType ingesteld op Start. De wizard voegt geen knop Vorige toe wanneer de StepType knop is ingesteld op Start ongeacht hoe de gebruiker naar die stap navigeert.
Dezelfde stap in de geschiedenis: een gebruiker bezoekt stap 3 waarop StepType is ingesteld Step en de gebruiker voert hun acties niet door. Ze klikken vervolgens op de vorige knop in stap 3. Het besturingselement van de wizard controleert of de vorige stap in de geschiedenis dezelfde stap is als waarop de gebruiker zich momenteel bevindt. Als de stap hetzelfde is, kijkt het wizard-besturingselement terug in de geschiedenis om de voorgaande 'verschillende' stap te bepalen en baseert u de weergave van de knop Vorige en het doel op basis van de 'andere stap' in de geschiedenis.

Note

Wanneer de AllowReturn eigenschap is ingesteld op false, maar de DisplaySideBar eigenschap van het bovenliggende besturingselement WizardStepBase is ingesteld trueop , heeft het klikken op een knop in het zijbalkgebied geen effect. Het zijbalkgebied wordt over het algemeen weergegeven om niet-lineaire navigatie te bieden, dus als u niet de functionaliteit van niet-lineaire navigatie gebruikt, kunt u de DisplaySideBar eigenschap instellen op false.

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Van toepassing op

Zie ook