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

Property Value

ICredentials

Ein ICredentials-Objekt mit den mit der Anforderung verknüpften Authentifizierungsanmeldeinformationen.An ICredentials containing the authentication credentials associated with the request. Der Standardwert lautet null.The default is null.

Exceptions

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.

Examples

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 der UseDefaultCredentials-Eigenschaft auf 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)

Remarks

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.

Note

Die WebRequest-Klasse ist eine abstract-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 der WebRequest.Create-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 der Dokumentation zu den Nachfolger 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.

Applies to

See also