PreAuthenticate Property

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:
property bool PreAuthenticate {
	bool get();
	void set(bool value);
}

Property Value

Type: System::Boolean

Returns 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 4.5
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1
Return to top
Show:
© 2016 Microsoft