WebProxy::Credentials 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 credentials to submit to the proxy server for authentication.

Namespace:   System.Net
Assembly:  System (in System.dll)

public:
property ICredentials^ Credentials {
	virtual ICredentials^ get() sealed;
	virtual void set(ICredentials^ value) sealed;
}

Property Value

Type: System.Net::ICredentials^

An ICredentials instance that contains the credentials to submit to the proxy server for authentication.

Exception Condition
InvalidOperationException

You attempted to set this property when the UseDefaultCredentials property was set to true.

The Credentials property contains the authentication credentials to send to the proxy server in response to an HTTP 407 (proxy authorization) status code. In most client scenarios, you should use the DefaultCredentials, which are the credentials of the currently logged on user. To do this, set the UseDefaultCredentials property to true instead of setting this property.

System_CAPS_noteNote

If you set the Credentials property to credentials other than the DefaultCredentials, setting the UseDefaultCredentials property to true causes a InvalidOperationException. To prevent this, you must set the Credentials property to null before setting the UseDefaultCredentials property to true. Likewise, you cannot set this property to any value when UseDefaultCredentials is true.

.NET Framework
Available since 1.1
Return to top
Show: