Control.ViewStateMode プロパティ

定義

このコントロールのビューステート モードを取得または設定します。Gets or sets the view-state mode of this control.

public:
 virtual property System::Web::UI::ViewStateMode ViewStateMode { System::Web::UI::ViewStateMode get(); void set(System::Web::UI::ViewStateMode value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ViewStateMode ViewStateMode { get; set; }
member this.ViewStateMode : System.Web.UI.ViewStateMode with get, set
Public Overridable Property ViewStateMode As ViewStateMode

プロパティ値

このコントロールのビューステート モード。The view-state mode of this control.

属性

例外

このプロパティを ViewStateMode 列挙値にない値に設定しようとしました。An attempt was made to set this property to a value that is not in the ViewStateMode enumeration.

注釈

ページのビューステートが無効になっている場合でも、ViewStateMode プロパティを使用して、個々のコントロールのビューステートを有効にすることができます。You can use the ViewStateMode property to enable view state for an individual control even if view state is disabled for the page. ビューステートとコントロールの状態の詳細については、EnableViewState プロパティを参照してください。For more information about view state and control state, see the EnableViewState property.

ページのビューステートを無効にして、ページの特定のコントロールに対して有効にするには、ページの EnableViewState プロパティとコントロールを trueに設定し、ページの ViewStateMode プロパティをに設定し Disabledを指定し、コントロールの ViewStateMode プロパティを Enabledに設定します。To disable view state for a page and to enable it for a specific control on the page, set the EnableViewState property of the page and the control to true, set the ViewStateMode property of the page to Disabled, and set the ViewStateMode property of the control to Enabled.

ページの [ViewStateMode] プロパティの既定値は Enabledです。The default value of the ViewStateMode property for a page is Enabled. ページ内の Web サーバーコントロールの ViewStateMode プロパティの既定値は Inheritです。The default value of the ViewStateMode property for a Web server control in a page is Inherit. その結果、ページまたはコントロールレベルでこのプロパティを設定しなかった場合、EnableViewState プロパティの値によってビューステートの動作が決定されます。As a result, if you do not set this property at either the page or the control level, the value of the EnableViewState property determines view-state behavior.

ページまたはコントロールの ViewStateMode プロパティは、EnableViewState プロパティが trueに設定されている場合にのみ効果があります。The ViewStateMode property of a page or a control has an effect only if the EnableViewState property is set to true. EnableViewState プロパティが falseに設定されている場合、ViewStateMode プロパティが Enabledに設定されていても、ビューステートはオフになります。If the EnableViewState property is set to false, view state will be turned off even if the ViewStateMode property is set to Enabled.

適用対象

こちらもご覧ください