WebRequest.Credentials Property

Definition

При переопределении во вложенном классе возвращает или задает сетевые учетные данные, используемые для проверки подлинности запроса на интернет-ресурсе.When overridden in a descendant class, gets or sets the network credentials used for authenticating the request with the Internet resource.

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; }
member this.Credentials : System.Net.ICredentials with get, set
Public Overridable Property Credentials As ICredentials

Property Value

ICredentials

Объект ICredentials, содержащий учетные записи проверки подлинности, связанные с запросом.An ICredentials containing the authentication credentials associated with the request. Значение по умолчанию — null.The default is null.

Exceptions

Если свойство не переопределено во вложенном классе, предпринимаются все возможные попытки вернуть или задать его.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Examples

В следующем примере свойство Credentials задается с помощью учетных данных текущего пользователя по умолчанию.The following example sets the Credentials property using the default credentials of the current user. При выполнении запроса учетные данные, хранящиеся в этом свойстве, используются для проверки клиента.When the request is made, credentials stored in this property are used to validate the client. Это идентично присвоению свойству UseDefaultCredentials значения true.This is identical to setting the UseDefaultCredentials property to 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)

Remarks

Свойство Credentials содержит учетные данные для проверки подлинности, необходимые для доступа к Интернет ресурсу.The Credentials property contains the authentication credentials required to access the Internet resource.

Note

Класс WebRequest является abstractным классом.The WebRequest class is an abstract class. Фактическое поведение WebRequest экземпляров во время выполнения определяется классом-наследником, возвращенным методом WebRequest.Create.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Дополнительные сведения о значениях по умолчанию и исключениях см. в документации по классам-наследникам, таким как HttpWebRequest и FileWebRequest.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Applies to

See also