WizardStepBase.AllowReturn Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om användaren får återgå till det aktuella steget från ett efterföljande steg i en WizardStepCollection samling.

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

Egenskapsvärde

Boolean

trueom användaren tillåts återgå till det aktuella steget; annars . false Standardvärdet är true.

Attribut
ThemeableAttribute

Exempel

I följande exempel visas hur du använder AllowReturn egenskapen för att hindra användaren från att återgå till ett steg i Wizard kontrollen när den har använts. I exemplet Step1 har steget dess AllowReturn egenskap inställd på false. När användaren har lämnat Step1 steget visas ingen föregående knapp i steget 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>

Kommentarer

Egenskapen AllowReturn kan användas för att framtvinga linjär navigering i en Wizard kontroll. Om varje steg har sin AllowReturn egenskap inställd falsepå kan användaren inte återgå till ett steg när den har använts. Ett scenario där du kan använda den här funktionen är att inte tillåta att en användare återgår till ett steg när den har slutförts eftersom du bevarar data till en databas när varje steg har slutförts. Om du sparar data efter varje steg och tillåter att användaren återgår till ett steg och ändrar information när de har sparats kan de sparade data bli skadade. Genom att ange AllowReturn egenskapen till false, när användaren har lämnat ett steg, kommer de inte att kunna återgå till den och ändra några värden.

Egenskapen AllowReturn avgör hur och när knappen Föregående inte återges. I följande tabell beskrivs beteendet för återgivning av föregående knapp.

Scenario Behavior
Linjär: Steg 1 har AllowReturn angetts till false och användaråtgärden går till steg 2. Steg 2 visar inte knappen Föregående .
Icke-linjär: Steg 1 har AllowReturn angetts till false och användaråtgärden går till steg 3. Steg 3 visar inte knappen Föregående .
Marginallistknappar: Steg 2 har AllowReturn angetts till falseDisplaySideBar, true är inställt på och en användare klickar på sidopanelen. Inga knappar inaktiveras automatiskt i sidofältet när AllowReturn är inställt falsepå . Om en användare klickar på knappen ignoreras åtgärden.
Linjär och icke-linjär med anpassad mall: Steget har en anpassad navigeringsmall. Inget automatiskt döljande eller visning sker om AllowReturn anges till false när du använder en mall för navigering. Knappen Föregående ska vara valfri i mallen.
Med hjälp av Visual Studio Designer och ActiveStepIndex: Kontrollen har 5 steg, du arbetar med steg 4 och kör sidan. När steg 4 är renderas ActiveStepIndexknappen Föregående . Knappen Föregående är bara dold för StepType inställd på Step när föregående steg i historiken har AllowReturn angetts till false. Eftersom steg 4 återges först och det inte finns några steg i historiken är knappen Föregående inte dold.
Startsteg och icke-linjär navigering: En användare besöker steg 3 och steg 4 och sedan steg 1 som har StepType angetts till Start. Guiden lägger inte till knappen Föregående när den StepType är inställd på Start oavsett hur användaren navigerar till det steget.
Samma steg i historik: En användare besöker steg 3 där StepType är inställt på Step och användaren genomför inte sina åtgärder. De klickar sedan på föregående knapp i steg 3. Guiden kontrollerar om föregående steg i historiken är det "samma" steg som användaren för närvarande är på. Om steget är detsamma ser guidekontrollen tillbaka i historiken för att fastställa föregående "olika" steg och baserar visningen av knappen Föregående och målet baserat på det "olika steget" i historiken.

Note

När egenskapen AllowReturn är inställd falsepå , men DisplaySideBar egenskapen för den överordnade kontrollen WizardStepBase är inställd truepå , har det ingen effekt att klicka på en knapp i sidofältet. Sidopanelens område visas vanligtvis för att ge icke-linjär navigering, så om du inte använder funktionen för icke-linjär navigering kanske du vill ange DisplaySideBar egenskapen till false.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även