WizardStepBase.AllowReturn Vlastnost

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 určující, zda se uživatel může vrátit k aktuálnímu kroku z další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 jeho AllowReturn vlastnost nastavena na false. Jakmile uživatel krok opustí Step1 , v kroku se nezobrazí Step2 žá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 nastavenou AllowReturn vlastnost false, uživatel se po přístupu nebude moct vrátit ke kroku. Jedním ze scénářů, kdy můžete tuto funkci použít, je zakázat uživateli vrátit se k kroku po jeho dokončení, protože data zachovajíte do databáze při dokončení každého kroku. Pokud data uložíte po každém kroku a povolíte uživateli vrátit se ke kroku a po uložení změnit informace, můžou se uložená data poškodit. Nastavením vlastnosti na AllowReturnfalsehodnotu , 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 předchozí tlačítko není vykresleno. Následující tabulka popisuje chování vykreslování předchozího tlačítka.

Scénář	Chování
Lineární: Krok 1 je AllowReturn nastavený na `false` akci uživatele a přejde na krok 2.	Krok 2 nezobrazuje tlačítko Předchozí .
Nelineární: Krok 1 je AllowReturn nastavený na `false` akci uživatele a 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.	Na bočním panelu nejsou automaticky zakázána žádná tlačítka, pokud AllowReturn je nastavena na `false`hodnotu . Pokud uživatel klikne na tlačítko, akce se ignoruje.
Lineární a nelineární s vlastní šablonou: Krok obsahuje vlastní navigační šablonu.	Při použití šablony pro navigaci nedojde AllowReturn k `false` automatickému skrytí ani zobrazení. Tlačítko Předchozí by mělo být v šabloně volitelné.
Pomocí Návrháře sady Visual Studio a ActiveStepIndex : Ovládací prvek má 5 kroků, pracujete na kroku 4 a spustíte stránku.	Když je ActiveStepIndexkrok 4, zobrazí se tlačítko Předchozí . Tlačítko Předchozí je skryto pouze pro StepType nastavení, pokud Step předchozí krok v historii je AllowReturn nastaven na `false`. Vzhledem k tomu, že se krok 4 vykreslí jako první a v historii nejsou žádné kroky, tlačítko Předchozí není skryté.
Spuštění kroku a nelineární navigace: Uživatel navštíví krok 3 a krok 4 a pak krok 1, který je StepType nastavený na Start.	Průvodce nepřidá předchozí tlačítko, pokud StepType je nastavena Start na 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ý Step a uživatel neprovede 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, na který je uživatel aktuálně zapnutý. Pokud je krok stejný, ovládací prvek průvodce se vrátí do historie, aby určil předchozí krok "jiný" a zakládá zobrazení předchozího tlačítka a cíle na základě "jiného kroku" v historii.

Poznámka:

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

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

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?