Edit

Share via


IWebProxy.Credentials Property

Definition

The credentials to submit to the proxy server for authentication.

C#
public System.Net.ICredentials Credentials { get; set; }
C#
public System.Net.ICredentials? Credentials { get; set; }

Property Value

An ICredentials instance that contains the credentials that are needed to authenticate a request to the proxy server.

Examples

The following example uses the Credentials property to set the credentials that will be submitted to the proxy server for authentication.

C#
public class WebProxy_Interface : IWebProxy
{
    // The credentials to be used with the web proxy.
    private ICredentials iCredentials;

    // Uri of the associated proxy server.
    private Uri webProxyUri;

    public WebProxy_Interface(Uri proxyUri) {

        webProxyUri = proxyUri;
    }

    // Get and Set the Credentials property.
    public ICredentials Credentials {
        get {
            return iCredentials;
        }
        set {
            if(iCredentials != value)
                iCredentials = value;
        }
    }

    // Return the web proxy for the specified destination(destUri).
    public Uri? GetProxy(Uri destUri) {

        // Always use the same proxy.
        return webProxyUri;
    }

    // Return whether the web proxy should be bypassed for the specified destination(hostUri).
    public bool IsBypassed(Uri hostUri) {

        // Never bypass the proxy.
        return false;
    }
}

Remarks

The Credentials property is an ICredentials instance that contains the authorization credentials to send to the proxy server in response to an HTTP 407 (proxy authorization) status code.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0