ICredentialPolicy.ShouldSendCredential 方法

定义

命名空间:

System.Net

程序集:

System.Net.Requests.dll

返回一个 Boolean，该值指示客户端的凭据是否随使用 WebRequest 类的实例发出的资源请求一起发送。

public:
 bool ShouldSendCredential(Uri ^ challengeUri, System::Net::WebRequest ^ request, System::Net::NetworkCredential ^ credential, System::Net::IAuthenticationModule ^ authenticationModule);

public bool ShouldSendCredential (Uri challengeUri, System.Net.WebRequest request, System.Net.NetworkCredential credential, System.Net.IAuthenticationModule authenticationModule);

abstract member ShouldSendCredential : Uri * System.Net.WebRequest * System.Net.NetworkCredential * System.Net.IAuthenticationModule -> bool

Public Function ShouldSendCredential (challengeUri As Uri, request As WebRequest, credential As NetworkCredential, authenticationModule As IAuthenticationModule) As Boolean

参数

challengeUri

Uri

将接收该请求的 Uri。

request

WebRequest

表示被请求的资源的 WebRequest。

credential

NetworkCredential

将随请求一起发送的 NetworkCredential（如果此方法返回 true）。

authenticationModule

IAuthenticationModule

将执行身份验证的 IAuthenticationModule（如果要求身份验证）。

返回

Boolean

如果凭据随请求一起发送，则为 true；否则，为 false。

注解

ICredentialPolicy通过设置 AuthenticationManager.CredentialPolicy 属性指定策略后，IAuthenticationModule处理 身份验证的 WebRequest 将在ShouldSendCredential执行身份验证之前调用 方法。 如果此方法返回 false，则不执行身份验证。

当原始请求已重定向或需要代理身份验证时，标识 challengeUri 的资源可能不同于 中指定的 WebRequest.RequestUri请求资源。 在重定向的情况下， challengeUri 包含实际的目标 Uri。 如果需要代理身份验证， challengeUri 则包含需要客户端身份验证的代理服务器的地址。