WebRequest.Credentials Eigenschaft

Definition

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

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

Ausnahmen

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:

Weitere Informationen