WebRequest.Credentials Propriété

Définition

En cas de substitution dans une classe descendante, obtient ou définit les informations d'identification réseau utilisées pour authentifier la demande auprès de la ressource Internet.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

Valeur de propriété

ICredentials contenant les informations d'authentification associées à la demande.An ICredentials containing the authentication credentials associated with the request. La valeur par défaut est null.The default is null.

Exceptions

Toutes les tentatives possibles sont effectuées pour obtenir ou définir la propriété si celle-ci n’est pas substituée dans une classe descendante.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Exemples

L’exemple suivant définit la Credentials propriété à l’aide des informations d’identification par défaut de l’utilisateur actuel.The following example sets the Credentials property using the default credentials of the current user. Lorsque la demande est effectuée, les informations d’identification stockées dans cette propriété sont utilisées pour valider le client.When the request is made, credentials stored in this property are used to validate the client. Cela est identique à l’affectation UseDefaultCredentials de truela valeur à la propriété.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)

Remarques

La Credentials propriété contient les informations d’authentification requises pour accéder à la ressource Internet.The Credentials property contains the authentication credentials required to access the Internet resource.

Notes

La WebRequest classe est une abstract classe.The WebRequest class is an abstract class. Le comportement réel des WebRequest instances au moment de l’exécution est déterminé par la classe descendante WebRequest.Create retournée par la méthode.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Pour plus d’informations sur les valeurs par défaut et les exceptions, consultez la documentation des classes descendantes FileWebRequest, telles que HttpWebRequest et.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

S’applique à

Voir aussi