HttpClientHandler.PreAuthenticate Property

Definition

Namespace:

System.Net.Http

Assemblies:

netstandard.dll, System.Net.Http.dll

Source:

HttpClientHandler.cs

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

C#

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool PreAuthenticate { get; set; }

Property Value

Boolean

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

Attributes

UnsupportedOSPlatformAttribute

Remarks

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.

Applies to