AuthenticationManager.CredentialPolicy Свойство

Определение

Возвращает или задает политику учетных данных, которую следует использовать для запросов ресурсов, выполняемых с использованием класса HttpWebRequest.Gets or sets the credential policy to be used for resource requests made using the HttpWebRequest class.

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; }
public static System.Net.ICredentialPolicy CredentialPolicy { get; set; }
member this.CredentialPolicy : System.Net.ICredentialPolicy with get, set
Public Shared Property CredentialPolicy As ICredentialPolicy

Значение свойства

ICredentialPolicy

Объект, реализующий интерфейс ICredentialPolicy, который определяет, отправляются ли учетные данные вместе с запросами.An object that implements the ICredentialPolicy interface that determines whether credentials are sent with requests. Значение по умолчанию — null.The default value is null.

Примеры

В следующем примере кода показано задание политики учетных данных.The following code example demonstrates setting the credential policy.

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

Комментарии

Политика учетных данных определяет, следует ли отправлять учетные данные при отправке запроса к сетевому ресурсу, например к содержимому веб-страницы.The credential policy determines whether to send credentials when sending a request for a network resource, such as the content of a Web page. При отправке учетных данных серверы, которым требуется проверка подлинности клиента, могут попытаться проверить подлинность клиента при получении запроса вместо отправки ответа, указывающего на необходимость в учетных данных клиента.If credentials are sent, servers that require client authentication can attempt to authenticate the client when the request is received instead of sending a response indicating that the client's credentials are required. Хотя это экономит круговой путь к серверу, это должно быть сбалансировано от угроз безопасности, присущих для отправки учетных данных по сети.While this saves a round trip to the server, this must be balanced against the security risk inherent in sending credentials across the network. Если сервер назначения не требует проверки подлинности клиента, лучше не передавать учетные данные.When the destination server does not require client authentication it is best to not send credentials.

Политика учетных данных будет вызываться только для запросов, которые задают учетные данные или используют WebProxy объект, указывающий учетные данные.The credential policy will be called only for requests that specify credentials or use a WebProxy object that specifies credentials.

Применяется к