Udostępnij za pośrednictwem

WizardStepBase.AllowReturn Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość wskazującą, czy użytkownik może wrócić do bieżącego kroku z kolejnego kroku w WizardStepCollection kolekcji.

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

Wartość właściwości

Boolean

true jeśli użytkownik może wrócić do bieżącego kroku; w przeciwnym razie , false. Wartość domyślna to true.

Atrybuty
ThemeableAttribute

Przykłady

W poniższym przykładzie pokazano użycie AllowReturn właściwości , aby uniemożliwić użytkownikowi powrót do kroku w kontrolce Wizard po jej dokonaniu dostępu. W tym przykładzie Step1 krok ma właściwość AllowReturn ustawioną na false. Gdy użytkownik opuści Step1 krok, w kroku nie zostanie Step2 wyświetlony przycisk Wstecz.

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

Uwagi

Właściwość AllowReturn może służyć do wymuszania nawigacji liniowej w kontrolce Wizard . Jeśli każdy krok ma ustawioną AllowReturnfalsewłaściwość , użytkownik nie będzie mógł wrócić do kroku po jego dokonaniu dostępu. Jednym ze scenariuszy, w których można użyć tej funkcji, jest uniemożliwienie użytkownikowi powrotu do kroku po zakończeniu, ponieważ dane są utrwalane w bazie danych podczas każdego kroku. Jeśli zapiszesz dane po każdym kroku i zezwolisz użytkownikowi na powrót do kroku i zmianę informacji po ich zapisaniu, zapisane dane mogą ulec uszkodzeniu. Ustawiając AllowReturn właściwość na false, gdy użytkownik opuścił krok, nie będzie mógł do niej powrócić i zmienić żadnych wartości.

Właściwość AllowReturn określa, jak i kiedy przycisk Wstecz nie jest renderowany. W poniższej tabeli opisano zachowanie renderowania przycisku Wstecz .

Scenariusz Zachowanie
Liniowy: Krok 1 ma ustawioną AllowReturn wartość false , a akcja użytkownika przechodzi do kroku 2. Krok 2 nie wyświetla przycisku Wstecz .
Nieliniowy: krok 1 został AllowReturn ustawiony na false i akcja użytkownika przechodzi do kroku 3. Krok 3 nie wyświetla przycisku Wstecz .
Przyciski paska bocznego: Krok 2 ma AllowReturn ustawioną wartość false , DisplaySideBar jest ustawiona na true, a użytkownik klika przycisk Pasek boczny. Przyciski nie są automatycznie wyłączone na pasku bocznym, gdy AllowReturn jest ustawiona na falsewartość . Jeśli użytkownik kliknie przycisk, akcja zostanie zignorowana.
Liniowa & nieliniowa z szablonem niestandardowym: krok ma niestandardowy szablon nawigacji. Nie ma automatycznego ukrywania lub wyświetlania, jeśli AllowReturn jest ustawiona wartość false w przypadku korzystania z szablonu na potrzeby nawigacji. Przycisk Wstecz powinien być opcjonalny w szablonie.
Przy użyciu projektanta programu Visual Studio i ActiveStepIndex : Kontrolka ma 5 kroków, pracujesz w kroku 4 i uruchamiasz stronę. Gdy krok 4 to ActiveStepIndex, przycisk Wstecz jest renderowany. Przycisk Wstecz jest ukryty tylko dla StepType ustawienia , Step gdy poprzedni krok w historii ma AllowReturn ustawioną wartość false. Ponieważ krok 4 jest renderowany jako pierwszy i nie ma żadnych kroków w historii, przycisk Wstecz nie jest ukryty.
Rozpocznij krok i nawigację nieliniową: użytkownik odwiedza krok 3 i krok 4, a następnie krok 1, który ma StepType ustawioną wartość Start. Kreator nie dodaje przycisku Wstecz , gdy StepType element jest ustawiony na Start wartość niezależnie od tego, jak użytkownik przechodzi do tego kroku.
Ten sam krok w historii: użytkownik odwiedza krok 3, w którym StepType jest ustawiona wartość Step , a użytkownik nie zatwierdza swoich akcji. Następnie klikają poprzedni przycisk w kroku 3. Kontrolka kreatora sprawdza, czy poprzedni krok w historii jest "tym samym" krokiem, w jakim użytkownik jest aktualnie włączony. Jeśli krok jest taki sam, kontrolka kreatora patrzy wstecz w historii, aby określić poprzedni krok "inny" i podstawy wyświetlania poprzedniego przycisku i miejsca docelowego na podstawie "innego kroku" w historii.

Uwaga

AllowReturn Gdy właściwość jest ustawiona na false, ale DisplaySideBar właściwość kontrolki nadrzędnej WizardStepBase jest ustawiona na true, kliknięcie przycisku w obszarze paska bocznego nie ma wpływu. Obszar paska bocznego jest ogólnie wyświetlany w celu zapewnienia nawigacji nieliniowej, więc jeśli nie używasz funkcji nawigacji nieliniowej, możesz ustawić DisplaySideBar właściwość na falsewartość .

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skórki.

Dotyczy

Zobacz też