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

注意

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

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

適用於

另請參閱