WizardStepBase.AllowReturn 屬性

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得或設定值，指出是否允許使用者從 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時，則會轉譯上一個按鈕。只有當歷程記錄中的上一個步驟設定AllowReturn`false`為時，才會隱藏 StepType Step[上一步] 按鈕。因為步驟 4 會先轉譯，而且歷程記錄中沒有步驟，所以不會隱藏上一個按鈕。
開始步驟和非線性導覽：使用者瀏覽步驟 3 和步驟 4，然後步驟 1 已 StepType 設定為 Start。	無論使用者流覽至該步驟的方式為何，精靈都不會在設定 Start 為時StepType新增 [上一步] 按鈕。
歷程記錄中的相同步驟：用戶流覽步驟 3，其中 StepType 設定為 Step ，且使用者不會認可其動作。然後，他們會在步驟 3 上按兩下上一個按鈕。	精靈控件會檢查歷程記錄中的上一個步驟是否為使用者目前所在的「相同」步驟。如果步驟相同，精靈控件會回到歷程記錄中，以判斷先前的「不同」步驟，並根據歷程記錄中的「不同步驟」來顯示上一個按鈕和目的地。

注意

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

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

適用於

共用方式為

WizardStepBase.AllowReturn 屬性

定義

屬性值

範例

備註

適用於

另請參閱

其他資源