共用方式為

WizardStepBase.AllowReturn 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定值，指出是否允許使用者從 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

屬性值

Boolean

如果允許使用者返回目前步驟，則為 true，否則為 false。 預設值是 true。

屬性
ThemeableAttribute

範例

下列範例示範如何使用 AllowReturn 屬性來阻止使用者在存取控件之後返回 控件中的 Wizard 步驟。 在這裡範例中 Step1 ，步驟的 AllowReturn 屬性設定為 false。 使用者離開 Step1 步驟之後，步驟上 Step2 不會顯示 [上一步] 按鈕。

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

備註

AllowReturn屬性可用來在控件中Wizard強制執行線性導覽。 如果每個步驟的 AllowReturn 屬性都設定為 false，則使用者將無法在存取步驟之後返回步驟。 您可能會使用這項功能的其中一個案例，就是不允許使用者在完成步驟之後返回步驟，因為您要將數據保存到資料庫，因為每個步驟都已完成。 如果您在每一個步驟之後儲存數據，並允許使用者返回步驟，並在儲存后變更資訊，則儲存的數據可能會損毀。 藉由將 AllowReturn 屬性設定為 false，一旦使用者離開步驟，他們就無法返回該屬性並變更任何值。

屬性 AllowReturn 會決定未轉譯 上一個 按鈕的方式和時機。 下表描述 上一個 按鈕轉譯行為。

狀況 行為
線性：步驟 1 已 AllowReturn 設定為 false ，而用戶動作會移至步驟 2。 步驟 2 不會顯示 [上一步 ] 按鈕。
非線性：步驟 1 已 AllowReturn 設定為 false ，而用戶動作會移至步驟 3。 步驟 3 不會顯示 [ 上一步 ] 按鈕。
SideBar 按鈕：步驟 2 已AllowReturn設定true為 false ，DisplaySideBar且使用者按兩下 [側邊欄] 按鈕。 當 設定為 false時AllowReturn，不會在提要欄中自動停用任何按鈕。 如果使用者按鍵，則會忽略動作。
線性 & 具有自定義範本的非線性：此步驟具有自定義導覽範本。 當您 AllowReturn 使用範本進行瀏覽時， false 不會自動隱藏或顯示。 [ 上一個] 按鈕在範本上應該是選擇性的。
使用 Visual Studio Designer 和 ActiveStepIndex ：控件有 5 個步驟，您正在執行步驟 4，並執行頁面。 當步驟 4 是 ActiveStepIndex時，則會轉譯 上一個 按鈕。 只有當歷程記錄中的上一個步驟設定AllowReturnfalse為 時，才會隱藏 StepTypeStep[上一步] 按鈕。 因為步驟 4 會先轉譯，而且歷程記錄中沒有步驟，所以不會隱藏 上一個 按鈕。
開始步驟和非線性導覽：使用者瀏覽步驟 3 和步驟 4，然後步驟 1 已 StepType 設定為 Start。 無論使用者流覽至該步驟的方式為何，精靈都不會在 設定 Start 為 時StepType新增 [上一步] 按鈕。
歷程記錄中的相同步驟：用戶流覽步驟 3，其中 StepType 設定為 Step ，且使用者不會認可其動作。 然後，他們會在步驟 3 上按兩下上一個按鈕。 精靈控件會檢查歷程記錄中的上 一 個步驟是否為使用者目前所在的「相同」步驟。 如果步驟相同，精靈控件會回到歷程記錄中，以判斷先前的「不同」步驟，並根據歷程記錄中的「不同步驟」來顯示 上 一個按鈕和目的地。

注意

當 屬性 AllowReturn 設定為 false，但 DisplaySideBar 的父控件 WizardStepBase 的 屬性設定 true為 時，按兩下提要字段中的按鈕不會有任何作用。 側邊欄區域通常會顯示以提供非線性導覽，因此如果您未使用非線性導覽的功能，您可能想要將 屬性設定 DisplaySideBar 為 false。

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊，請參閱 ThemeableAttribute 和 ASP.NET 主題和面板。

適用於

另請參閱