WebRequest.Credentials Eigenschaft

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: WebRequest.cs

Quelle:: WebRequest.cs

Quelle:: WebRequest.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wenn sie in einer untergeordneten Klasse überschrieben werden, werden die Netzwerkanmeldeinformationen abgerufen oder festgelegt, die zum Authentifizieren der Anforderung mit der Internetressource verwendet werden.

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

Eigenschaftswert

ICredentials

Eine ICredentials, die die Authentifizierungsanmeldeinformationen enthält, die der Anforderung zugeordnet sind. Der Standardwert ist null.

Ausnahmen

NotImplementedException

Es wird versucht, die Eigenschaft abzurufen oder festzulegen, wenn die Eigenschaft nicht in einer untergeordneten Klasse überschrieben wird.

Beispiele

Im folgenden Beispiel wird die Credentials-Eigenschaft mithilfe der Standardanmeldeinformationen des aktuellen Benutzers festgelegt. Wenn die Anforderung gestellt wird, werden in dieser Eigenschaft gespeicherte Anmeldeinformationen verwendet, um den Client zu überprüfen. Dies ist identisch mit dem Festlegen der UseDefaultCredentials-Eigenschaft auf 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)

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die eigenschaft Credentials enthält die Authentifizierungsanmeldeinformationen, die für den Zugriff auf die Internetressource erforderlich sind.

Anmerkung

Die WebRequest Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebRequest Instanzen zur Laufzeit wird durch die von der WebRequest.Create-Methode zurückgegebene absteigende Klasse bestimmt. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in der Dokumentation für die untergeordneten Klassen, z. B. HttpWebRequest und FileWebRequest.

Gilt für:

Freigeben über