<Type Name="NSUrlSessionHandler" FullName="System.Net.Http.NSUrlSessionHandler">

<summary>The default message handler used by <see cref="T:System.Net.Http.HttpClient" /> on Apple platforms using the Xamarin stack (iOS, macOS, watchOS, tvOS)</summary>

<remarks>

<para>The NSUrlSessionHandler is an HTTP client handler that delegates its work to Apple’s built-in <see cref="T:Foundation.NSUrlSession" />.   This is the default when you compile your application, but you can opt-out of it manually in your application by selecting a different handler.  </para>

<para />

<para>Using the Apple NSUrlSession has some advantages over using any socket-based implementation, the chief one being that on a mobile device, it will automatically turn on the radio on your behalf and you will avoid a potential timeout or an error if the radio is down.</para>

<para />

<para>Additionally, you can configure the handler to continue your downloads even if your application is suspended or has stopped running.</para>

</remarks>

<summary>The default constructor for NSUrlSessionHandler configures the handler with a <see cref="T:Foundation.NSUrlSessionConfiguration" /> set to the default value, and customizes the resources time out to be 24 hours (as infinite timeouts are not supported by Apple’s own transport).</summary>

<summary>Gets or sets a value that allows automatic redirection. Its default value is <see langword="true" />.</summary>

<value><see langword="true" /> to allow automatic redirection; otherwise, <see langword="false" />.</value>

<summary>Gets or sets authentication information used by this handler.</summary>

<value>The authentication credentials associated with the handler. The default is <see langword="null" />.</value>

<param name="request">The HTTP request message to send.</param>

<param name="cancellationToken">The cancellation token to cancel the operation.</param>

<summary>Sends an HTTP request as an asynchronous operation.</summary>

<returns>The task object representing the asynchronous operation.</returns>

<remarks>This operation is does not block. It returns an instance of <see cref="T:System.Threading.Tasks.Task`1" /> to represent the asynchronous operation. When the operation completes, <see cref="P:System.Threading.Tasks.Task`1.Result" /> contains the response message.</remarks>

</Type>