Condividi tramite

WebRequest.Credentials Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs

Quando sottoposto a override in una classe discendente, ottiene o imposta le credenziali di rete usate per autenticare la richiesta con la risorsa 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

Valore della proprietà

ICredentials

ICredentials contenente le credenziali di autenticazione associate alla richiesta. Il valore predefinito è null.

Eccezioni

NotImplementedException

Qualsiasi tentativo viene effettuato per ottenere o impostare la proprietà, quando la proprietà non viene sottoposta a override in una classe discendente.

Esempio

Nell'esempio seguente viene impostata la proprietà Credentials utilizzando le credenziali predefinite dell'utente corrente. Quando viene effettuata la richiesta, le credenziali archiviate in questa proprietà vengono usate per convalidare il client. È identico all'impostazione della proprietà UseDefaultCredentials su 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)

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

La proprietà Credentials contiene le credenziali di autenticazione necessarie per accedere alla risorsa Internet.

Nota

La classe WebRequest è una classe abstract. Il comportamento effettivo delle istanze di WebRequest in fase di esecuzione è determinato dalla classe discendente restituita dal metodo WebRequest.Create. Per altre informazioni sui valori predefiniti e sulle eccezioni, vedere la documentazione per le classi discendenti, ad esempio HttpWebRequest e FileWebRequest.

Si applica a

Vedi anche