WebRequest.UseDefaultCredentials Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

When overridden in a descendant class, gets or sets a Boolean value that controls whether DefaultCredentials are sent with requests.

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

public virtual bool UseDefaultCredentials { get; set; }

Property Value

Type: System.Boolean

true if the default credentials are used; otherwise false. The default value is false.

Exception Condition

You attempted to set this property after the request was sent.


Any attempt is made to access the property, when the property is not overridden in a descendant class.

Set this property to true when requests made by this WebRequest object should, if requested by the server, be authenticated using the credentials of the currently logged on user. For client applications, this is the desired behavior in most scenarios. For middle tier applications, such as ASP.NET applications, instead of using this property, you would typically set the Credentials property to the credentials of the client on whose behalf the request is made.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Available since 4.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top