WebRequest.Credentials Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в классе-потомке получает или задает сетевые учетные данные, используемые для проверки подлинности запроса с помощью ресурса Интернета.
public:
virtual property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };public virtual System.Net.ICredentials Credentials { get; set; }public virtual System.Net.ICredentials? Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Overridable Property Credentials As ICredentialsЗначение свойства
ICredentials, содержащий учетные данные проверки подлинности, связанные с запросом. Значение по умолчанию — null.
Исключения
Любая попытка получить или задать свойство, если свойство не переопределяется в классе-потомке.
Примеры
В следующем примере задается свойство Credentials с использованием учетных данных по умолчанию текущего пользователя. При выполнении запроса учетные данные, хранящиеся в этом свойстве, используются для проверки клиента. Это идентично установке свойства UseDefaultCredentials на true.
// Create a request for the URL.
WebRequest^ request = WebRequest::Create( "http://www.contoso.com/default.html" );
// If required by the server, set the credentials.
request->Credentials = CredentialCache::DefaultCredentials;
// Get the response.
HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
// Create a request for the URL.
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Свойство Credentials содержит учетные данные проверки подлинности, необходимые для доступа к интернет-ресурсу.
Заметка
Класс WebRequest — это класс abstract. Фактическое поведение экземпляров WebRequest во время выполнения определяется классом-потомком, возвращаемым методом WebRequest.Create. Дополнительные сведения о значениях и исключениях по умолчанию см. в документации по классам-потомкам, таким как HttpWebRequest и FileWebRequest.
