Udostępnij za pośrednictwem

WebRequest.Credentials Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.Requests.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
WebRequest.cs
Źródło:
WebRequest.cs
Źródło:
WebRequest.cs

Po zastąpieniu w klasie potomnej pobiera lub ustawia poświadczenia sieciowe używane do uwierzytelniania żądania za pomocą zasobu internetowego.

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

Wartość właściwości

ICredentials

ICredentials zawierający poświadczenia uwierzytelniania skojarzone z żądaniem. Wartość domyślna to null.

Wyjątki

NotImplementedException

Każda próba pobrania lub ustawienia właściwości, gdy właściwość nie jest zastępowana w klasie potomnej.

Przykłady

Poniższy przykład ustawia właściwość Credentials przy użyciu domyślnych poświadczeń bieżącego użytkownika. Po wysłaniu żądania poświadczenia przechowywane w tej właściwości są używane do sprawdzania poprawności klienta. Jest to identyczne z ustawieniem właściwości UseDefaultCredentials na wartość 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)

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Właściwość Credentials zawiera poświadczenia uwierzytelniania wymagane do uzyskania dostępu do zasobu internetowego.

Nuta

Klasa WebRequest jest klasą abstract. Rzeczywiste zachowanie wystąpień WebRequest w czasie wykonywania jest określane przez klasę potomną zwracaną przez metodę WebRequest.Create. Aby uzyskać więcej informacji na temat wartości domyślnych i wyjątków, zobacz dokumentację klas potomnych, takich jak HttpWebRequest i FileWebRequest.

Dotyczy

Zobacz też