1327 lines
57 KiB
C#
1327 lines
57 KiB
C#
using System.Diagnostics.CodeAnalysis;
|
|
using System.Net.Http.Headers;
|
|
using System.Runtime.Versioning;
|
|
|
|
namespace Discord.API.Rest.HttpClientWrapper;
|
|
|
|
/// <summary>
|
|
/// Interface wrapper around the HttpClient to use for tests
|
|
/// </summary>
|
|
/// remarks Copied over from decompiled HttpClient code.
|
|
public interface IHttpClientWrapper{
|
|
public HttpVersionPolicy DefaultVersionPolicy { get; set; }
|
|
//
|
|
// Summary:
|
|
// Gets or sets the default HTTP version used on subsequent requests made by this
|
|
// System.Net.Http.HttpClient instance.
|
|
//
|
|
// Returns:
|
|
// The default version to use for any requests made with this System.Net.Http.HttpClient
|
|
// instance.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// In a set operation, DefaultRequestVersion is null.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The System.Net.Http.HttpClient instance has already started one or more requests.
|
|
//
|
|
//
|
|
// T:System.ObjectDisposedException:
|
|
// The System.Net.Http.HttpClient instance has already been disposed.
|
|
public Version DefaultRequestVersion { get; set; }
|
|
//
|
|
// Summary:
|
|
// Gets the headers which should be sent with each request.
|
|
//
|
|
// Returns:
|
|
// The headers which should be sent with each request.
|
|
public HttpRequestHeaders DefaultRequestHeaders { get; }
|
|
//
|
|
// Summary:
|
|
// Gets or sets the base address of Uniform Resource Identifier (URI) of the Internet
|
|
// resource used when sending requests.
|
|
//
|
|
// Returns:
|
|
// The base address of Uniform Resource Identifier (URI) of the Internet resource
|
|
// used when sending requests.
|
|
public Uri? BaseAddress { get; set; }
|
|
//
|
|
// Summary:
|
|
// Gets or sets the maximum number of bytes to buffer when reading the response
|
|
// content.
|
|
//
|
|
// Returns:
|
|
// The maximum number of bytes to buffer when reading the response content. The
|
|
// default value for this property is 2 gigabytes.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentOutOfRangeException:
|
|
// The size specified is less than or equal to zero.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// An operation has already been started on the current instance.
|
|
//
|
|
// T:System.ObjectDisposedException:
|
|
// The current instance has been disposed.
|
|
public long MaxResponseContentBufferSize { get; set; }
|
|
//
|
|
// Summary:
|
|
// Gets or sets the timespan to wait before the request times out.
|
|
//
|
|
// Returns:
|
|
// The timespan to wait before the request times out.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentOutOfRangeException:
|
|
// The timeout specified is less than or equal to zero and is not System.Threading.Timeout.InfiniteTimeSpan.
|
|
//
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// An operation has already been started on the current instance.
|
|
//
|
|
// T:System.ObjectDisposedException:
|
|
// The current instance has been disposed.
|
|
public TimeSpan Timeout { get; set; }
|
|
|
|
//
|
|
// Summary:
|
|
// Cancel all pending requests on this instance.
|
|
public void CancelPendingRequests();
|
|
//
|
|
// Summary:
|
|
// Send a DELETE request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
// -or- The requestUri is not an absolute URI. -or- System.Net.Http.HttpClient.BaseAddress
|
|
// is not set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> DeleteAsync(Uri? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a DELETE request to the specified Uri with a cancellation token as an asynchronous
|
|
// operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
// -or- The requestUri is not an absolute URI. -or- System.Net.Http.HttpClient.BaseAddress
|
|
// is not set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> DeleteAsync([StringSyntax("Uri")] string? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a DELETE request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
// -or- The requestUri is not an absolute URI. -or- System.Net.Http.HttpClient.BaseAddress
|
|
// is not set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> DeleteAsync([StringSyntax("Uri")] string? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a DELETE request to the specified Uri with a cancellation token as an asynchronous
|
|
// operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
// -or- The requestUri is not an absolute URI. -or- System.Net.Http.HttpClient.BaseAddress
|
|
// is not set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> DeleteAsync(Uri? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri with an HTTP completion option as an
|
|
// asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// completionOption:
|
|
// An HTTP completion option value that indicates when the operation should be considered
|
|
// completed.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> GetAsync([StringSyntax("Uri")] string? requestUri, HttpCompletionOption completionOption);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> GetAsync([StringSyntax("Uri")] string? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri with an HTTP completion option and a
|
|
// cancellation token as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// completionOption:
|
|
// An HTTP completion option value that indicates when the operation should be considered
|
|
// completed.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> GetAsync(Uri? requestUri, HttpCompletionOption completionOption, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri with an HTTP completion option as an
|
|
// asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// completionOption:
|
|
// An HTTP completion option value that indicates when the operation should be considered
|
|
// completed.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> GetAsync(Uri? requestUri, HttpCompletionOption completionOption);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> GetAsync(Uri? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri with a cancellation token as an asynchronous
|
|
// operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> GetAsync([StringSyntax("Uri")] string? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri with an HTTP completion option and a
|
|
// cancellation token as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// completionOption:
|
|
// An HTTP completion option value that indicates when the operation should be considered
|
|
// completed.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> GetAsync([StringSyntax("Uri")] string? requestUri, HttpCompletionOption completionOption, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri with a cancellation token as an asynchronous
|
|
// operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> GetAsync(Uri? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Sends a GET request to the specified Uri and return the response body as a byte
|
|
// array in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<byte[]> GetByteArrayAsync([StringSyntax("Uri")] string? requestUri);
|
|
//
|
|
// Summary:
|
|
// Sends a GET request to the specified Uri and return the response body as a byte
|
|
// array in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<byte[]> GetByteArrayAsync([StringSyntax("Uri")] string? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a byte
|
|
// array in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<byte[]> GetByteArrayAsync(Uri? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a byte
|
|
// array in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<byte[]> GetByteArrayAsync(Uri? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a stream
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<Stream> GetStreamAsync([StringSyntax("Uri")] string? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a stream
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
public Task<Stream> GetStreamAsync([StringSyntax("Uri")] string? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a stream
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<Stream> GetStreamAsync(Uri? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a stream
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The requestUri is null.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<Stream> GetStreamAsync(Uri? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a string
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<string> GetStringAsync(Uri? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a string
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<string> GetStringAsync([StringSyntax("Uri")] string? requestUri);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a string
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The requestUri is null.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<string> GetStringAsync([StringSyntax("Uri")] string? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a GET request to the specified Uri and return the response body as a string
|
|
// in an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The requestUri is null.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation (or timeout for .NET Framework only).
|
|
//
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<string> GetStringAsync(Uri? requestUri, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Sends a PATCH request with a cancellation token to a Uri represented as a string
|
|
// as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> PatchAsync([StringSyntax("Uri")] string? requestUri, HttpContent? content, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Sends a PATCH request to a Uri designated as a string as an asynchronous operation.
|
|
//
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> PatchAsync([StringSyntax("Uri")] string? requestUri, HttpContent? content);
|
|
//
|
|
// Summary:
|
|
// Sends a PATCH request as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
public Task<HttpResponseMessage> PatchAsync(Uri? requestUri, HttpContent? content);
|
|
//
|
|
// Summary:
|
|
// Sends a PATCH request with a cancellation token as an asynchronous operation.
|
|
//
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
public Task<HttpResponseMessage> PatchAsync(Uri? requestUri, HttpContent? content, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a POST request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> PostAsync([StringSyntax("Uri")] string? requestUri, HttpContent? content);
|
|
//
|
|
// Summary:
|
|
// Send a POST request with a cancellation token as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> PostAsync([StringSyntax("Uri")] string? requestUri, HttpContent? content, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a POST request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> PostAsync(Uri? requestUri, HttpContent? content);
|
|
//
|
|
// Summary:
|
|
// Send a POST request with a cancellation token as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> PostAsync(Uri? requestUri, HttpContent? content, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a PUT request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> PutAsync(Uri? requestUri, HttpContent? content);
|
|
//
|
|
// Summary:
|
|
// Send a PUT request with a cancellation token as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> PutAsync(Uri? requestUri, HttpContent? content, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send a PUT request to the specified Uri as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> PutAsync([StringSyntax("Uri")] string? requestUri, HttpContent? content);
|
|
//
|
|
// Summary:
|
|
// Send a PUT request with a cancellation token as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// requestUri:
|
|
// The Uri the request is sent to.
|
|
//
|
|
// content:
|
|
// The HTTP request content sent to the server.
|
|
//
|
|
// cancellationToken:
|
|
// A cancellation token that can be used by other objects or threads to receive
|
|
// notice of cancellation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.InvalidOperationException:
|
|
// The requestUri must be an absolute URI or System.Net.Http.HttpClient.BaseAddress
|
|
// must be set.
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
//
|
|
// T:System.UriFormatException:
|
|
// The provided request URI is not valid relative or absolute URI.
|
|
public Task<HttpResponseMessage> PutAsync([StringSyntax("Uri")] string? requestUri, HttpContent? content, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Sends an HTTP request with the specified request, completion option and cancellation
|
|
// token.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// completionOption:
|
|
// One of the enumeration values that specifies when the operation should complete
|
|
// (as soon as a response is available or after reading the response content).
|
|
//
|
|
// cancellationToken:
|
|
// The token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The HTTP response message.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.NotSupportedException:
|
|
// The HTTP version is 2.0 or higher or the version policy is set to System.Net.Http.HttpVersionPolicy.RequestVersionOrHigher.
|
|
// -or- The custom class derived from System.Net.Http.HttpContent does not override
|
|
// the System.Net.Http.HttpContent.SerializeToStream(System.IO.Stream,System.Net.TransportContext,System.Threading.CancellationToken)
|
|
// method. -or- The custom System.Net.Http.HttpMessageHandler does not override
|
|
// the System.Net.Http.HttpMessageHandler.Send(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)
|
|
// method.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, or server certificate validation.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// The request was canceled. -or- If the System.Threading.Tasks.TaskCanceledException
|
|
// exception nests the System.TimeoutException: The request failed due to timeout.
|
|
[UnsupportedOSPlatform("browser")]
|
|
public HttpResponseMessage Send(HttpRequestMessage request, HttpCompletionOption completionOption, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Sends an HTTP request with the specified request and cancellation token.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// cancellationToken:
|
|
// The token to cancel the operation.
|
|
//
|
|
// Returns:
|
|
// The HTTP response message.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.NotSupportedException:
|
|
// The HTTP version is 2.0 or higher or the version policy is set to System.Net.Http.HttpVersionPolicy.RequestVersionOrHigher.
|
|
// -or- The custom class derived from System.Net.Http.HttpContent does not override
|
|
// the System.Net.Http.HttpContent.SerializeToStream(System.IO.Stream,System.Net.TransportContext,System.Threading.CancellationToken)
|
|
// method. -or- The custom System.Net.Http.HttpMessageHandler does not override
|
|
// the System.Net.Http.HttpMessageHandler.Send(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)
|
|
// method.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, or server certificate validation.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// The request was canceled. -or- If the System.Threading.Tasks.TaskCanceledException
|
|
// exception nests the System.TimeoutException: The request failed due to timeout.
|
|
[UnsupportedOSPlatform("browser")]
|
|
public HttpResponseMessage Send(HttpRequestMessage request, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Sends an HTTP request.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// completionOption:
|
|
// One of the enumeration values that specifies when the operation should complete
|
|
// (as soon as a response is available or after reading the response content).
|
|
//
|
|
// Returns:
|
|
// The HTTP response message.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.NotSupportedException:
|
|
// The HTTP version is 2.0 or higher or the version policy is set to System.Net.Http.HttpVersionPolicy.RequestVersionOrHigher.
|
|
// -or- The custom class derived from System.Net.Http.HttpContent does not override
|
|
// the System.Net.Http.HttpContent.SerializeToStream(System.IO.Stream,System.Net.TransportContext,System.Threading.CancellationToken)
|
|
// method. -or- The custom System.Net.Http.HttpMessageHandler does not override
|
|
// the System.Net.Http.HttpMessageHandler.Send(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)
|
|
// method.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, or server certificate validation.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// If the System.Threading.Tasks.TaskCanceledException exception nests the System.TimeoutException:
|
|
// The request failed due to timeout.
|
|
[UnsupportedOSPlatform("browser")]
|
|
public HttpResponseMessage Send(HttpRequestMessage request, HttpCompletionOption completionOption);
|
|
//
|
|
// Summary:
|
|
// Sends an HTTP request with the specified request.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// Returns:
|
|
// An HTTP response message.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.NotSupportedException:
|
|
// The HTTP version is 2.0 or higher or the version policy is set to System.Net.Http.HttpVersionPolicy.RequestVersionOrHigher.
|
|
// -or- The custom class derived from System.Net.Http.HttpContent does not override
|
|
// the System.Net.Http.HttpContent.SerializeToStream(System.IO.Stream,System.Net.TransportContext,System.Threading.CancellationToken)
|
|
// method. -or- The custom System.Net.Http.HttpMessageHandler does not override
|
|
// the System.Net.Http.HttpMessageHandler.Send(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)
|
|
// method.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, or server certificate validation.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// If the System.Threading.Tasks.TaskCanceledException exception nests the System.TimeoutException:
|
|
// The request failed due to timeout.
|
|
[UnsupportedOSPlatform("browser")]
|
|
public HttpResponseMessage Send(HttpRequestMessage request);
|
|
//
|
|
// Summary:
|
|
// Send an HTTP request as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken);
|
|
//
|
|
// Summary:
|
|
// Send an HTTP request as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> SendAsync(HttpRequestMessage request);
|
|
//
|
|
// Summary:
|
|
// Send an HTTP request as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// completionOption:
|
|
// When the operation should complete (as soon as a response is available or after
|
|
// reading the whole response content).
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, HttpCompletionOption completionOption);
|
|
//
|
|
// Summary:
|
|
// Send an HTTP request as an asynchronous operation.
|
|
//
|
|
// Parameters:
|
|
// request:
|
|
// The HTTP request message to send.
|
|
//
|
|
// completionOption:
|
|
// When the operation should complete (as soon as a response is available or after
|
|
// reading the whole response content).
|
|
//
|
|
// cancellationToken:
|
|
// The cancellation token to cancel operation.
|
|
//
|
|
// Returns:
|
|
// The task object representing the asynchronous operation.
|
|
//
|
|
// Exceptions:
|
|
// T:System.ArgumentNullException:
|
|
// The request is null.
|
|
//
|
|
// T:System.InvalidOperationException:
|
|
// The request message was already sent by the System.Net.Http.HttpClient instance.
|
|
//
|
|
//
|
|
// T:System.Net.Http.HttpRequestException:
|
|
// The request failed due to an underlying issue such as network connectivity, DNS
|
|
// failure, server certificate validation or timeout.
|
|
//
|
|
// T:System.Threading.Tasks.TaskCanceledException:
|
|
// .NET Core and .NET 5 and later only: The request failed due to timeout.
|
|
public Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, HttpCompletionOption completionOption, CancellationToken cancellationToken);
|
|
} |