Partage via


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 requête avec la ressource Internet.

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, set
Public Overridable Property Credentials As ICredentials

Valeur de propriété

Une ICredentials contenant les informations d’identification d’authentification associées à la demande. La valeur par défaut est null.

Exceptions

Toute tentative est effectuée pour obtenir ou définir la propriété, lorsque la propriété n’est pas remplacée dans une classe descendante.

Exemples

L’exemple suivant définit la propriété Credentials à l’aide des informations d’identification par défaut de l’utilisateur actuel. Lorsque la demande est effectuée, les informations d’identification stockées dans cette propriété sont utilisées pour valider le client. Cela est identique à la définition de la propriété UseDefaultCredentials sur 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

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La propriété Credentials contient les informations d’identification d’authentification requises pour accéder à la ressource Internet.

Note

La classe WebRequest est une classe abstract. Le comportement réel des instances de WebRequest au moment de l’exécution est déterminé par la classe descendante retournée par la méthode WebRequest.Create. Pour plus d’informations sur les valeurs et exceptions par défaut, consultez la documentation relative aux classes descendantes, telles que HttpWebRequest et FileWebRequest.

S’applique à

Voir aussi