WebRequest.Credentials WebRequest.Credentials WebRequest.Credentials WebRequest.Credentials Property

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.When overridden in a descendant class, gets or sets the network credentials used for authenticating the request with the Internet resource.

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 mit den mit der Anforderung verknüpften Authentifizierungsanmeldeinformationen.An ICredentials containing the authentication credentials associated with the request. Der Standardwert ist null.The default is null.

Ausnahmen

Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer Nachfolgerklasse nicht überschrieben wurde.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Beispiele

Im folgenden Beispiel wird die Credentials Eigenschaft, die mit den Standardanmeldeinformationen des aktuellen Benutzers.The following example sets the Credentials property using the default credentials of the current user. Wenn die Anforderung gesendet wird, werden Anmeldeinformationen, die in dieser Eigenschaft gespeichert, überprüft der Client verwendet.When the request is made, credentials stored in this property are used to validate the client. Dies ist identisch mit der Einstellung der UseDefaultCredentials Eigenschaft true.This is identical to setting the UseDefaultCredentials property to 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 Anmeldeinformationen für die Authentifizierung erforderlich, um Zugriff auf die Internetressource.The Credentials property contains the authentication credentials required to access the Internet resource.

Hinweis

Die WebRequest -Klasse ist ein abstract Klasse.The WebRequest class is an abstract class. Das tatsächliche Verhalten der WebRequest Instanzen zur Laufzeit wird von der abgeleiteten Klasse, die vom bestimmt die WebRequest.Create Methode.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Weitere Informationen zum Default-Werte und Ausnahmen finden Sie unter der Dokumentation für den abgeleiteten Klassen, z. B. HttpWebRequest und FileWebRequest.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Gilt für:

Siehe auch