WebRequest.Credentials Eigenschaft

Definition

Ruft beim Überschreiben in einer Nachfolgerklasse die Netzwerkanmeldeinformationen, die für die Authentifizierung der Anforderung der Internetressource verwendet werden, ab oder legt diese fest.

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

Ein ICredentials-Objekt mit den mit der Anforderung verknüpften Authentifizierungsanmeldeinformationen. Der Standardwert ist null.

Ausnahmen

Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer Nachfolgerklasse nicht überschrieben wurde.

Beispiele

Im folgenden Beispiel wird die Credentials Eigenschaft mithilfe der Standardanmeldeinformationen des aktuellen Benutzers festgelegt. Wenn die Anforderung vorgenommen wird, werden Anmeldeinformationen verwendet, die in dieser Eigenschaft gespeichert sind, 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

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

Hinweis

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

Gilt für:

Siehe auch