HttpClientHandler.PreAuthenticate Property

.NET Framework (current version)

Gets or sets a value that indicates whether the handler sends an Authorization header with the request.

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

public bool PreAuthenticate { get; set; }

Property Value

Type: System.Boolean

true for the handler to send an HTTP Authorization header with requests after authentication has taken place; otherwise, false. The default is false.

After a client request to a specific Uri is successfully authenticated, if the PreAuthenticate property is true and credentials are supplied, HttpClientHandler matches against the credential list supplied in the Credentials property. The Authorization header is sent with each request to any Uri that matches the specific Uri up to the last forward slash.

If the client request to a specific Uri is not successfully authenticated, the request uses standard authentication procedures.

With the exception of the first request, the PreAuthenticate property indicates whether to send authentication information with subsequent requests to a Uri that matches the specific Uri up to the last forward slash without waiting to be challenged by the server.

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