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に設定されている場合、ユーザーはアクセス後にステップに戻ることができません。この機能を使用するシナリオの 1 つは、各手順の完了後にデータをデータベースに保持するため、完了した後にユーザーがステップに戻りを禁止することです。各ステップの後にデータを保存し、ユーザーがステップに戻り、保存後に情報を変更できるようにすると、保存されたデータが破損する可能性があります。 AllowReturn プロパティを false に設定すると、ユーザーがステップを終了すると、そのプロパティに戻って値を変更できなくなります。

AllowReturn プロパティは、[前へ] ボタンがレンダリングされない方法とタイミングを決定します。次の表では、[ 前へ ] ボタンのレンダリング動作について説明します。

シナリオ	Behavior
線形: ステップ 1 AllowReturn`false`に設定され、ユーザーアクションはステップ 2 に進みます。	手順 2 では、[ 前へ ] ボタンは表示されません。
非線形: ステップ 1 AllowReturn`false`に設定されており、ユーザーアクションは手順 3 に進みます。	手順 3 では、[ 前へ ] ボタンは表示されません。
サイドバーボタン: 手順 2 AllowReturn`false`に設定され、DisplaySideBarが`true`に設定され、ユーザーがサイドバーボタンをクリックします。	AllowReturnが`false`に設定されている場合、サイドバーのボタンは自動的に無効にされません。ユーザーがボタンをクリックすると、アクションは無視されます。
Linear と Non-Linear with Custom Template: このステップにはカスタムナビゲーションテンプレートがあります。	ナビゲーションにテンプレートを使用するときに AllowReturn が `false` に設定されている場合、自動非表示または表示は行われません。テンプレートの [ 前へ ] ボタンは省略可能である必要があります。
Visual Studio デザイナーと ActiveStepIndex を使用する: コントロールには 5 つの手順があり、手順 4 で作業し、ページを実行します。	手順 4 が ActiveStepIndexの場合、[ 前へ ] ボタンが表示されます。履歴の前の手順がに設定StepType場合、StepがAllowReturnに設定されている場合にのみ、[`false`] ボタンが非表示になります。手順 4 は最初にレンダリングされ、履歴にステップがないため、[ 前へ ] ボタンは非表示になりません。
ステップと非線形ナビゲーションを開始する: ユーザーは、手順 3 と手順 4 にアクセスし、手順 1 にアクセスします。この手順StepType Startに設定されています。	ユーザーがそのステップに移動する方法に関係なく、がStepTypeに設定されている場合、ウィザードは [Startへ] ボタンを追加しません。
履歴内の同じステップ: ユーザーは、 StepType が Step に設定され、ユーザーが自分のアクションをコミットしない手順 3 にアクセスします。次に、手順 3 の前のボタンをクリックします。	ウィザードコントロールは、履歴の前の手順が、ユーザーが現在オンになっている "同じ" ステップであるかどうかを確認します。手順が同じ場合、ウィザードコントロールは履歴を振り返り、前の "異なる" ステップを判断し、履歴の "異なるステップ" に基づいて [前へ ] ボタンと移動先の表示を基にします。

Note

AllowReturnプロパティがfalseに設定されていても、DisplaySideBarの親コントロールのWizardStepBaseプロパティがtrueに設定されている場合、サイドバー領域のボタンをクリックしても効果はありません。通常、サイドバー領域は非線形ナビゲーションを提供するために表示されるため、非線形ナビゲーションの機能を使用していない場合は、 DisplaySideBar プロパティを falseに設定できます。

このプロパティは、テーマまたはスタイルシートのテーマでは設定できません。詳細については、「テーマとスキンの ThemeableAttribute と ASP.NET」を参照してください。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?