CredentialCache.DefaultCredentials-Eigenschaft

Ruft die Systemanmeldeinformationen der Anwendung ab.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Shared ReadOnly Property DefaultCredentials As ICredentials
'Usage
Dim value As ICredentials

value = CredentialCache.DefaultCredentials

public static ICredentials DefaultCredentials { get; }

public:
static property ICredentials^ DefaultCredentials {
    ICredentials^ get ();
}

/** @property */
public static ICredentials get_DefaultCredentials ()

public static function get DefaultCredentials () : ICredentials

Eigenschaftenwert

Eine ICredentials-Instanz, die die Systemanmeldeinformationen der Anwendung darstellt.

Hinweise

Die DefaultCredentials-Eigenschaft gilt nur für die NTLM-, Negotiate- und Kerberos-Authentifizierung.

DefaultCredentials entsprechen den Systemanmeldeinformationen für den aktuellen Sicherheitskontext, in dem die Anwendung ausgeführt wird. Bei einer clientseitigen Anwendung sind dies i. d. R. die Windows-Anmeldeinformationen des Benutzers, der die Anwendung ausführt, d. h. Benutzername, Kennwort und Domäne. Bei ASP.NET-Anwendungen sind die Standardanmeldeinformationen die Anmeldeinformationen des derzeit angemeldeten Benutzers bzw. des Benutzers, dessen Identität verwendet wird.

Um die Anmeldeinformationen als NetworkCredential-Instanz abzurufen, verwenden Sie die DefaultNetworkCredentials-Eigenschaft.

Die unterstützten Werte für authType sind "NTLM", "Digest", "Kerberos" und "Negotiate". Diese Methode funktioniert nicht bei HTTP- oder FTP-Protokollen.

Beispiel

Im folgenden Beispiel werden mit der DefaultCredentials-Eigenschaft die Systemanmeldeinformationen der Anwendung abgerufen.

' Assuming "Windows Authentication" has been set as; 
' Directory Security settings for default web site in IIS.
Dim url As String = "https://localhost"
' Create a 'HttpWebRequest' object with the specified url. 
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(url), HttpWebRequest)
' Assign the credentials of the logged in user or the user being impersonated.
myHttpWebRequest.Credentials = CredentialCache.DefaultCredentials
' Send the 'HttpWebRequest' and wait for response.            
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Console.WriteLine("Authentication successful")
Console.WriteLine("Response received successfully")

// Ensure Directory Security settings for default web site in IIS is "Windows Authentication".
string url = "https://localhost";
// Create a 'HttpWebRequest' object with the specified url. 
HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.Create(url); 
// Assign the credentials of the logged in user or the user being impersonated.
myHttpWebRequest.Credentials = CredentialCache.DefaultCredentials;
// Send the 'HttpWebRequest' and wait for response.            
HttpWebResponse myHttpWebResponse = (HttpWebResponse)myHttpWebRequest.GetResponse(); 
Console.WriteLine("Authentication successful");
Console.WriteLine("Response received successfully");

// Ensure Directory Security settings for default web site in IIS is "Windows Authentication".
String^ url = "https://localhost";

// Create a 'HttpWebRequest' object with the specified url.
HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create( url ));

// Assign the credentials of the logged in user or the user being impersonated.
myHttpWebRequest->Credentials = CredentialCache::DefaultCredentials;

// Send the 'HttpWebRequest' and wait for response.
HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());
Console::WriteLine( "Authentication successful" );
Console::WriteLine( "Response received successfully" );

// Ensure Directory Security settings for default web site in IIS 
// is "Windows Authentication".
String url = "https://localhost";

// Create a 'HttpWebRequest' object with the specified url. 
HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.
    Create(url);

// Assign the credentials of the logged in user or the user being 
// impersonated.
myHttpWebRequest.set_Credentials(CredentialCache.
    get_DefaultCredentials());

// Send the 'HttpWebRequest' and wait for response.            
HttpWebResponse myHttpWebResponse 
    = (HttpWebResponse)myHttpWebRequest.GetResponse();

Console.WriteLine("Authentication successful");
Console.WriteLine("Response received successfully");

.NET Framework-Sicherheit

• EnvironmentPermission  zum Lesen der USERNAME-Umgebungsvariablen. Zugeordnete Enumeration: Read

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

Siehe auch

Referenz

CredentialCache-Klasse
CredentialCache-Member
System.Net-Namespace