WizardStepBase.AllowReturn Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu označující, zda je uživateli povoleno vrátit se k aktuálnímu kroku z následného kroku v kolekci WizardStepCollection .

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

Hodnota vlastnosti

Boolean

truepokud se uživatel může vrátit k aktuálnímu kroku; v opačném případě . false Výchozí hodnota je true.

Atributy: ThemeableAttribute

Příklady

Následující příklad ukazuje použití AllowReturn vlastnosti k zastavení uživatele v návratu ke kroku v ovládacím Wizard prvku po jeho přístupu. V příkladu Step1 má krok vlastnost AllowReturn nastavenou na false. Jakmile uživatel krok opustí Step1 , nezobrazí se v Step2 kroku žádné tlačítko Předchozí.

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

Poznámky

Vlastnost AllowReturn lze použít k vynucení lineární navigace v ovládacím Wizard prvku. Pokud má každý krok svoji AllowReturn vlastnost nastavenou na false, uživatel se po přístupu ke kroku nebude moct vrátit. Jedním ze scénářů, kdy můžete tuto funkci použít, je zakázat uživateli návrat ke kroku po jeho dokončení, protože při dokončení každého kroku se data uchovávají v databázi. Pokud uložíte data po každém kroku a umožníte uživateli vrátit se ke kroku a po uložení změnit informace, uložená data se můžou poškodit. Když vlastnost nastavíte AllowReturn na false, jakmile uživatel opustí krok, nebude se k němu moct vrátit a změnit žádné hodnoty.

Vlastnost AllowReturn určuje, jak a kdy se tlačítko Předchozí nevykreslí. Následující tabulka popisuje chování při vykreslování tlačítka Předchozí .

Scenario	Chování
Lineární: Krok 1 je AllowReturn nastavený na `false` a akce uživatele přejde na krok 2.	Krok 2 nezobrazuje tlačítko Předchozí .
Nelineární: Krok 1 je AllowReturn nastavený na `false` a akce uživatele přejde na krok 3.	Krok 3 nezobrazuje tlačítko Předchozí .
Tlačítka bočního panelu: Krok 2 je AllowReturn nastavený na `false` , DisplaySideBar je nastavený na `true`a uživatel klikne na tlačítko Boční panel.	Pokud AllowReturn je nastavená možnost `false`, nejsou na bočním panelu automaticky zakázaná žádná tlačítka. Pokud uživatel klikne na tlačítko, akce se ignoruje.
Lineární & nelineární s vlastní šablonou: Krok má vlastní šablonu navigace.	K automatickému skrytí nebo zobrazení nedojde, pokud AllowReturn je nastavena na hodnotu `false` při použití šablony pro navigaci. Tlačítko Předchozí by mělo být v šabloně volitelné.
Pomocí Visual Studio Designeru a ActiveStepIndex : Ovládací prvek má 5 kroků, pracujete na kroku 4 a spustíte stránku.	Když je ActiveStepIndexkrok 4 , vykreslí se tlačítko Předchozí . Tlačítko Předchozí je skryté, pouze pokud StepType Step je AllowReturn předchozí krok v historii nastavený na `false`hodnotu . Vzhledem k tomu, že krok 4 je vykreslen jako první a v historii nejsou žádné kroky, není tlačítko Předchozí skryté.
Zahájení kroku a nelineární navigace: Uživatel navštíví krok 3 a krok 4 a potom krok 1, který je StepType nastavený na Start.	Průvodce nepřidá tlačítko Předchozí , pokud StepType je nastavena na Start bez ohledu na to, jak uživatel přejde k danému kroku.
Stejný krok v historii: Uživatel navštíví krok 3, kde StepType je nastavený na Step a uživatel nepotřídí své akce. Potom kliknou na předchozí tlačítko v kroku 3.	Ovládací prvek průvodce zkontroluje, jestli předchozí krok v historii je "stejný" krok, u kterého se uživatel právě nachází. Pokud je krok stejný, ovládací prvek průvodce se podívá do historie, aby zjistil předchozí "odlišný" krok a za základ zobrazení tlačítka Předchozí a cíle na základě "jiného kroku" v historii.

Poznámka

AllowReturn Pokud je vlastnost nastavená na false, ale DisplaySideBar vlastnost nadřazeného ovládacího prvku WizardStepBase je nastavená na true, nemá kliknutí na tlačítko v oblasti bočního panelu žádný vliv. Oblast bočního panelu se obvykle zobrazuje tak, aby poskytovala nelineární navigaci, takže pokud nepoužíváte funkce nelineární navigace, můžete vlastnost nastavit DisplaySideBar na false.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Platí pro

Sdílet prostřednictvím