Page.ViewStateEncryptionMode Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the encryption mode of the view state.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

[BrowsableAttribute(false)]
public ViewStateEncryptionMode ViewStateEncryptionMode { get; set; }

Property Value

Type: System.Web.UI.ViewStateEncryptionMode

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

Exception Condition
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 PreRenderphase in the page life cycle.

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

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

<%@ 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>

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.

.NET Framework
Available since 2.0
Return to top
Show: