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.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. Die Standardeinstellung 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 mithilfe der Standard Anmelde Informationen des aktuellen Benutzers festgelegt.The following example sets the Credentials property using the default credentials of the current user. Wenn die Anforderung gestellt wird, werden die in dieser Eigenschaft gespeicherten Anmelde Informationen verwendet, um den Client zu validieren.When the request is made, credentials stored in this property are used to validate the client. Dies ist identisch mit dem Festlegen UseDefaultCredentials der- trueEigenschaft auf.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 für den Zugriff auf die Internet Ressource erforderlichen Anmelde Informationen für die Authentifizierung.The Credentials property contains the authentication credentials required to access the Internet resource.

Hinweis

Die WebRequest -Klasse ist abstract eine-Klasse.The WebRequest class is an abstract class. Das tatsächliche Verhalten von WebRequest -Instanzen zur Laufzeit wird von der Nachfolger Klasse bestimmt, die von WebRequest.Create der-Methode zurückgegeben wird.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in HttpWebRequest der Dokumentation zu den Nachfolger Klassen, z. b. und. FileWebRequestFor more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Gilt für:

Siehe auch