Page.ViewStateEncryptionMode Property

Reference

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the encryption mode of the view state.

public:
 property System::Web::UI::ViewStateEncryptionMode ViewStateEncryptionMode { System::Web::UI::ViewStateEncryptionMode get(); void set(System::Web::UI::ViewStateEncryptionMode value); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.ViewStateEncryptionMode ViewStateEncryptionMode { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.ViewStateEncryptionMode : System.Web.UI.ViewStateEncryptionMode with get, set

Public Property ViewStateEncryptionMode As ViewStateEncryptionMode

Property Value

ViewStateEncryptionMode

One of the ViewStateEncryptionMode values. The default value is Auto.

Attributes: BrowsableAttribute

Exceptions

ArgumentOutOfRangeException

The value set is not a member of the ViewStateEncryptionMode enumeration.

InvalidOperationException

The ViewStateEncryptionMode property can be set only in or before the page PreRender phase in the page life cycle.

Remarks

The ViewStateEncryptionMode property cannot be set in code. It can only be set in the @ Page directive or in the < element of the configuration file. Values set in the @ Page directive override any values set in the configuration file.

The syntax for setting this property in the @ Page directive is as follows:

<%@ Page Language="VB" ViewStateEncryptionMode="Always" %>

<%@ Page Language="C#" ViewStateEncryptionMode="Always" %>

The syntax for setting this property in the configuration file is as follows:

<system.web>  
  <pages viewStateEncryptionMode="Always" />  
</system.web>

<system.web>  
  <pages viewStateEncryptionMode="Always" />  
</system.web>

Custom control developers may wish to check the value of this property in code before saving potentially sensitive data to view state in their control.

Applies to

Share via