AuthenticationManager.CredentialPolicy 属性

定义

命名空间:

System.Net

程序集:

System.Net.Requests.dll

Source:

AuthenticationManager.cs

获取或设置凭据策略，该凭据策略将用于使用 HttpWebRequest 类发出的资源请求。

public:
 static property System::Net::ICredentialPolicy ^ CredentialPolicy { System::Net::ICredentialPolicy ^ get(); void set(System::Net::ICredentialPolicy ^ value); };

public static System.Net.ICredentialPolicy? CredentialPolicy { get; set; }

static member CredentialPolicy : System.Net.ICredentialPolicy with get, set

Public Shared Property CredentialPolicy As ICredentialPolicy

属性值

ICredentialPolicy

一个实现 ICredentialPolicy 接口的对象，该接口确定凭据是否随请求一起发送。 默认值是 null。

示例

下面的代码示例演示如何设置凭据策略。

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

注解

凭据策略确定在发送对网络资源（如网页内容）的请求时是否发送凭据。 如果发送了凭据，要求客户端身份验证的服务器可以在收到请求时尝试对客户端进行身份验证，而不是发送指示需要客户端凭据的响应。 虽然这可以节省到服务器的往返行程，但这必须与通过网络发送凭据时固有的安全风险进行平衡。 当目标服务器不需要客户端身份验证时，最好不要发送凭据。

仅对指定凭据或使用 WebProxy 指定凭据的对象的请求调用凭据策略。