WebRequest.Credentials Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Quelle:

WebRequest.cs

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; }

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

NotImplementedException

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 unter Verwendung der Standardanmeldeinformationen des aktuellen Benutzers festgelegt. Wenn die Anforderung gestellt wird, werden die in dieser Eigenschaft gespeicherten 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

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 von der WebRequest.Create -Methode zurückgegebene untergeordnete Klasse bestimmt. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in der Dokumentation für die untergeordneten Klassen, z. B HttpWebRequest . und FileWebRequest.

Weitere Informationen

• NetworkCredential
• CredentialCache
• Credentials