WebRequest.Credentials-Eigenschaft
Ruft beim Überschreiben in einer abgeleiteten Klasse die Netzwerkanmeldeinformationen, die für die Authentifizierung der Anforderung der Internetressource verwendet werden, ab oder legt diese fest.
Namespace: System.Net
Assembly: System (in system.dll)
Syntax
'Declaration
Public Overridable Property Credentials As ICredentials
'Usage
Dim instance As WebRequest
Dim value As ICredentials
value = instance.Credentials
instance.Credentials = value
public virtual ICredentials Credentials { get; set; }
public:
virtual property ICredentials^ Credentials {
ICredentials^ get ();
void set (ICredentials^ value);
}
/** @property */
public ICredentials get_Credentials ()
/** @property */
public void set_Credentials (ICredentials value)
public function get Credentials () : ICredentials
public function set Credentials (value : ICredentials)
Eigenschaftenwert
ICredentials mit den mit der Anforderung verknüpften Authentifizierungsanmeldeinformationen. Der Standardwert ist NULL (Nothing in Visual Basic).
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer abgeleiteten Klasse nicht überschrieben wurde. |
Hinweise
Die Credentials-Eigenschaft enthält die für den Zugriff auf die Internetressource erforderlichen Authentifizierungsanmeldeinformationen.
Hinweis
Die WebRequest-Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebRequest-Instanzen zur Laufzeit wird von der abgeleiteten Klasse bestimmt, die von der System.Net.WebRequest.Create-Methode zurückgegeben wird. Weitere Informationen über Standardwerte und Ausnahmen finden Sie in der Dokumentation zu den abgeleiteten Klassen, z. B. HttpWebRequest und FileWebRequest.
Beispiel
Im folgenden Beispiel wird die Credentials-Eigenschaft mit den Standardanmeldeinformationen des aktuellen Benutzers festgelegt. Während der Anforderung werden die in dieser Eigenschaft gespeicherten Anmeldeinformationen dazu verwendet, den Client zu überprüfen. Dies entspricht dem Festlegen der UseDefaultCredentials-Eigenschaft auf true.
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("https://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)
// Create a request for the URL.
WebRequest request = WebRequest.Create ("https://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.
WebRequest^ request = WebRequest::Create( "https://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());
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
WebRequest-Klasse
WebRequest-Member
System.Net-Namespace
NetworkCredential-Klasse
CredentialCache-Klasse
HttpWebRequest.Credentials-Eigenschaft