WebProxy.UseDefaultCredentials 属性

定义

命名空间:

System.Net

程序集:

System.Net.WebProxy.dll

Source:

WebProxy.cs

获取或设置 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 代表其发出请求的客户端的凭据，而不是使用此属性。

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

Credentials 值	UseDefaultCredentials 值	效果
DefaultCredentials	true	无效。
DefaultCredentials	false	将 Credentials 设置为 null。
null	true	将 Credentials 设置为 DefaultCredentials。
或 以外的 DefaultCredentials 任何值 null	true 或 false	设置 UseDefaultCredentials 将引发异常。

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