IdentitySection.Impersonate Property

Reference

Definition

Namespace:: System.Web.Configuration

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 a value indicating whether client impersonation is used on each request.

public:
 property bool Impersonate { bool get(); void set(bool value); };

[System.Configuration.ConfigurationProperty("impersonate", DefaultValue=false)]
public bool Impersonate { get; set; }

[<System.Configuration.ConfigurationProperty("impersonate", DefaultValue=false)>]
member this.Impersonate : bool with get, set

Public Property Impersonate As Boolean

Property Value

Boolean

true if client impersonation is used; otherwise, false. The default value is false.

Attributes: ConfigurationPropertyAttribute

Examples

The following code example shows how to access the Impersonate property. Refer to the code example of the IdentitySection class to learn how to access the section.

// Get the Impersonate property value.
bool currentImpersonate = identitySection.Impersonate;

// Set the Impersonate property to true.
identitySection.Impersonate = true;

' Get the Impersonate property value.
Dim currentImpersonate As Boolean = identitySection.Impersonate

' Set the Impersonate property to true.
identitySection.Impersonate = True

Remarks

If the Impersonate property is set to true, each request is served by a Web application impersonating its client. That is, either the user currently logged on or the user specified by the UserName and Password properties. When the Impersonate property is set to false, the application does not impersonate any client user.

Note

For security reasons, the identity section supports storage of the encrypted UserName and Password.

Applies to

Share via