WebConfigurationManager::OpenWebConfiguration Method (String^, String^, String^, String^, IntPtr)
Opens the Web-application configuration file as a Configuration object using the specified virtual path, site name, location, server, and security context to allow read or write operations.
Assembly: System.Web (in System.Web.dll)
public: [SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)] static Configuration^ OpenWebConfiguration( String^ path, String^ site, String^ locationSubPath, String^ server, IntPtr userToken )
Parameters
- path
-
Type:
System::String^
The virtual path to the configuration file.
- site
-
Type:
System::String^
The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.
- locationSubPath
-
Type:
System::String^
The specific resource to which the configuration applies.
- server
-
Type:
System::String^
The network name of the server the Web application resides on.
- userToken
-
Type:
System::IntPtr
An account token to use.
| Exception | Condition |
|---|---|
| ArgumentException | The server or userToken parameters were invalid. |
| ConfigurationErrorsException | A valid configuration file could not be loaded. |
This method is used to access a configuration file using impersonation.
 Note |
|---|
The account token is usually retrieved from an instance of the WindowsIdentity class or through a call to unmanaged code, such as a call to the Win32 API LogonUser. For more information about calls to unmanaged code, see Consuming Unmanaged DLL Functions. |
To obtain the Configuration object for a remote resource, your code must have administrative privileges on the remote computer.
Available since 2.0