WizardStepBase.AllowReturn Tulajdonság

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Lekéri vagy beállít egy értéket, amely jelzi, hogy a felhasználó visszatérhet-e az aktuális lépéshez egy WizardStepCollection gyűjtemény későbbi lépéséből.

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

Tulajdonság értéke

Boolean

trueha a felhasználó visszatérhet az aktuális lépéshez; egyéb esetben. false Az alapértelmezett érték a true.

Attribútumok: ThemeableAttribute

Példák

Az alábbi példa bemutatja, hogy a AllowReturn tulajdonság használatával megakadályozható, hogy a felhasználó visszatérjen a vezérlő egy lépésére a Wizard hozzáférése után. A példában a Step1 lépés tulajdonsága AllowReturn a következőre falsevan állítva: . Miután a felhasználó elhagyta a Step1 lépést, nem jelenik meg az Előző gomb a Step2 lépésen.

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

Megjegyzések

A AllowReturn tulajdonság segítségével lineáris navigációt kényszeríthet ki egy Wizard vezérlőben. Ha minden lépéshez AllowReturn a tulajdonsága van beállítva false, a felhasználó nem tud visszatérni egy lépéshez a hozzáférése után. Az egyik forgatókönyv, amikor ezt a funkciót használhatja, az, hogy letiltja a felhasználó számára, hogy visszatérjen egy lépéshez a befejezése után, mert az adatokat az egyes lépések befejezésekor megőrzi egy adatbázisban. Ha minden lépés után menti az adatokat, és engedélyezi a felhasználónak, hogy visszatérjen egy lépéshez, és a mentés után módosítsa az adatokat, a mentett adatok megsérülhetnek. Ha úgy állítja be a AllowReturn tulajdonságot, hogy falsemiután a felhasználó elhagyta a lépést, nem fog tudni visszatérni hozzá, és nem módosíthatja az értékeket.

A AllowReturn tulajdonság határozza meg, hogy az Előző gomb hogyan és mikor nem jelenik meg. Az alábbi táblázat az Előző gomb renderelési viselkedését ismerteti.

Scenario	Magatartás
Lineáris: Az 1. lépés értéke AllowReturn , `false` a felhasználói művelet pedig a 2. lépésre kerül.	A 2. lépés nem jeleníti meg az Előző gombot.
Nem lineáris: Az 1. lépés be van AllowReturn állítva, `false` és a felhasználói művelet a 3. lépésre kerül.	A 3. lépés nem jeleníti meg az Előző gombot.
Oldalsávgombok: A 2AllowReturn. lépés a következőre `false` van állítvaDisplaySideBar, `true` és a felhasználó az Oldalsáv gombra kattint.	Az oldalsávon nincsenek automatikusan letiltva gombok, ha AllowReturn be van állítva.`false` Ha egy felhasználó a gombra kattint, a művelet figyelmen kívül lesz hagyva.
Lineáris és nem lineáris egyéni sablonnal: A lépés egyéni navigációs sablonnal rendelkezik.	Nem történik automatikus elrejtés vagy megjelenítés, ha AllowReturn a `false` navigációhoz sablont használ. Az Előző gombnak kötelezőnek kell lennie a sablonon.
A Visual Studio Tervező és a ActiveStepIndex: A vezérlő 5 lépésből áll, a 4. lépésen dolgozik, és ön futtatja a lapot.	Ha a 4. lépés az ActiveStepIndex, akkor az Előző gomb jelenik meg. Az Előző gomb csak akkor van elrejtve StepType , Step ha az előzmény előző lépése be van AllowReturn állítva `false`. Mivel a 4. lépés először jelenik meg, és nincsenek lépések az előzményekben, az Előző gomb nem rejtett.
Kezdő lépés és nem lineáris navigáció: A felhasználó felkeresi a 3. és a 4. lépést, majd az 1. lépést, amely a következőre StepTypevan Start állítva: .	A varázsló nem ad hozzá Előző gombot, ha a StepType beállítás a felhasználó lépésétől függetlenül be van állítva Start .
Ugyanaz a lépés az előzményekben: A felhasználó felkeresi a 3. lépést, ahol StepType be van állítva Step , és a felhasználó nem véglegesíti a műveleteit. Ezután a 3. lépésben kattintson az előző gombra.	A varázsló vezérlőelem ellenőrzi, hogy az előzmény előző lépése ugyanaz-e, mint a felhasználó jelenleg. Ha a lépés ugyanaz, a varázslóvezérlő visszatekint az előzményekbe, hogy meghatározza az előző "eltérő" lépést, és az előzmények "eltérő lépése" alapján alapozza az Előző gomb és a cél megjelenítését.

Note

Ha a AllowReturn tulajdonság be van állítva false, de a DisplaySideBar szülő vezérlőelem tulajdonsága WizardStepBase a következőre truevan állítva, az oldalsáv területén lévő gombra kattintásnak nincs hatása. Az oldalsáv területe általában nemlineáris navigációt biztosít, ezért ha nem használja a nemlineáris navigáció funkcióit, érdemes lehet a tulajdonságot DisplaySideBara false következőre állítani.

Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?