WizardStepBase.AllowReturn Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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 truea 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í sady Visual Studio Designer 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 StepTypeStep je AllowReturn předchozí krok v historii nastavený na falsehodnotu . 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

Viz také