WebProxy.UseDefaultCredentials 属性

定义

命名空间:

System.Net

程序集:

System.Net.WebProxy.dll

程序集:

System.dll

程序集:

netstandard.dll

获取或设置 Boolean 值，该值控制 DefaultCredentials 是否随请求一起发送。

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

public bool UseDefaultCredentials { get; set; }

member this.UseDefaultCredentials : bool with get, set

Public Property UseDefaultCredentials As Boolean

属性值

Boolean

如果使用默认凭据，则为 true；否则为 false。 默认值是 false。

例外

InvalidOperationException

当 Credentials 属性包含默认凭据以外的凭据时，尝试设置此属性。

注解

如果服务器请求WebProxy请求，应使用当前登录用户的凭据进行身份验证，请将此属性设置为true此对象发出的请求。 对于客户端应用程序，这是大多数情况下所需的行为。 对于中间层应用程序（例如 ASP.NET 应用程序），通常将属性设置为Credentials代表请求的客户端的凭据。

下表根据属性的值Credentials显示设置UseDefaultCredentials值的效果。

Credentials 值	UseDefaultCredentials 值	效果
DefaultCredentials	true	无效。
DefaultCredentials	false	将 Credentials 设置为 null。
null	true	将 Credentials 设置为 DefaultCredentials。
除 DefaultCredentials 或 null	true 或 false	设置 UseDefaultCredentials 会引发异常。

false如果是UseDefaultCredentials，可以将属性更改为Credentials任何凭据。 true如果是UseDefaultCredentials，请将Credentials属性从DefaultCredentials (属性设置为true) 时UseDefaultCredentials设置的值将引发异常。