Export (0) Print
Expand All

CredentialCache::DefaultCredentials Property

Gets the system credentials of the application.

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

static property ICredentials^ DefaultCredentials {
	ICredentials^ get ();

Property Value

Type: System.Net::ICredentials
An ICredentials that represents the system credentials of the application.

The DefaultCredentials property applies only to NTLM, negotiate, and Kerberos-based authentication.

DefaultCredentials represents the system credentials for the current security context in which the application is running. For a client-side application, these are usually the Windows credentials (user name, password, and domain) of the user running the application. For ASP.NET applications, the default credentials are the user credentials of the logged-in user, or the user being impersonated.

To get the credentials as a NetworkCredential instance, use the DefaultNetworkCredentials property.

The supported values for authType are "NTLM", "Digest", "Kerberos", and "Negotiate". This method does not work for HTTP or FTP protocols.


The ICredentials instance returned by DefaultCredentials cannot be used to view the user name, password, or domain of the current security context.

The following code example uses the DefaultCredentials property to get the system credentials of the application.

      // Ensure Directory Security settings for default web site in IIS is "Windows Authentication".
      String^ url = "http://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" );

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft