Interface IHttpBehaviour

The IHttpBehaviour is used to control the behaviour of all operations in the HttpExtensions library.

The default encoding which is used wherever an encoding is specified. The default is set to Encoding.UTF8

This can be used to change the behaviour of Http operation, default is to read the complete response.

This is the list of IHttpContentConverters which is used when converting from/to HttpContent

Pass your HttpSettings here, which will be used to create the HttpClient If not specified, the HttpSettings.GlobalSettings will be used

This is used to de- serialize Json, can be overwritten by your own implementation. By default, also when empty, the SimpleJsonSerializer is used.

An action which can modify the HttpClient which is generated in the HttpClientFactory. Use cases for this, might be adding a header or other settings for specific cases

An Func which can modify the HttpContent right before it's used to start the request. This can be used to add a specific header, e.g. set a filename etc, or return a completely different HttpContent type

An Func which can modify or wrap the HttpMessageHandler which is generated in the HttpMessageHandlerFactory. Use cases for this, might be if you have very specify settings which can't be set via the IHttpSettings Or you want to add additional behaviour (extend DelegatingHandler!!) like the OAuthDelegatingHandler

An Func which can modify the HttpRequestMessage right before it's used to start the request. This can be used to add a specific header, which should not be for all requests. As the called func has access to HttpRequestMessage with the content, uri and method this is quite usefull, it can return a completely different HttpRequestMessage

Specify the buffer for reading operations

If a request gets a response which has a HTTP status code which is an error, it would normally THROW an exception. Sometimes you would still want the response, settings this to false would allow this. This can be ignored for all HttpResponse returning methods.

IProgress for uploading, only used when using non-string content like Bitmaps or MemoryStreams. Also the UseProgressStreamContent needs to be true for detailed upload progress

Whenever a post is made to upload memorystream or bitmaps, this value is used to decide: true: ProgressStreamContent is used, instead of StreamContent

Check if the response has the expected content-type, when servers are used that are not following specifications this should be set to false

Clone this HttpBehavior and return an interface which can be used to write

Set this IHttpBehaviour on the CallContext