diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml index dd8e06f9136..e8857d6eb23 100644 --- a/xml/System.Net.Http/HttpClient.xml +++ b/xml/System.Net.Http/HttpClient.xml @@ -68,7 +68,8 @@ is intended to be instantiated once and re-used throughout the life of an application. Instantiating an HttpClient class for every request will exhaust the number of sockets available under heavy loads. This will result in SocketException errors. Below is an example using HttpClient correctly. + + is intended to be instantiated once and reused throughout the life of an application. Instantiating an HttpClient class for every request will exhaust the number of sockets available under heavy loads. This will result in SocketException errors. Below is an example using HttpClient correctly. ```csharp public class GoodController : ApiController @@ -263,9 +264,9 @@ The specified `handler` will be disposed of by calling [HttpClient.Dispose](xref with a relative Uri, the message Uri will be added to the property to create an absolute Uri. + When sending a with a relative URI, the message URI is added to the property to create an absolute URI. - Note that all characters after the right-most "/" in the base URI are excluded when combined with the message URI. See [RFC 3986](https://tools.ietf.org/html/rfc3986) Uniform Resource Identifier (URI) Generic Syntax specification. + Note that all characters after the right-most "/" in the base URI are excluded when combined with the message URI. See [RFC 3986](https://tools.ietf.org/html/rfc3986) Uniform Resource Identifier Generic Syntax specification. ]]> @@ -507,7 +508,7 @@ This property has no effect on any of the 4.2.0.0 - Send a DELETE request to the specified Uri as an asynchronous operation. + Send a DELETE request to the specified URI as an asynchronous operation. @@ -556,20 +557,21 @@ This property has no effect on any of the - The Uri the request is sent to. - Send a DELETE request to the specified Uri as an asynchronous operation. + The URI the request is sent to. + Send a DELETE request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, different exceptions are thrown on different .NET implementations. +> In case of timeout, different exceptions are thrown on different .NET implementations: +> +> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. ]]> The request message was already sent by the instance. @@ -582,7 +584,7 @@ The is not an absolute URI. is not set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -627,20 +629,21 @@ The is not an absolute URI. - The Uri the request is sent to. - Send a DELETE request to the specified Uri as an asynchronous operation. + The URI the request is sent to. + Send a DELETE request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, different exceptions are thrown on different .NET implementations. +> In case of timeout, different exceptions are thrown on different .NET implementations: +> +> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. ]]> The request message was already sent by the instance. @@ -653,7 +656,7 @@ The is not an absolute URI. is not set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -703,21 +706,22 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Send a DELETE request to the specified Uri with a cancellation token as an asynchronous operation. + Send a DELETE request to the specified URI with a cancellation token as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. +> +> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. ]]> The request message was already sent by the instance. @@ -730,8 +734,11 @@ The is not an absolute URI. is not set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -777,21 +784,22 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Send a DELETE request to the specified Uri with a cancellation token as an asynchronous operation. + Send a DELETE request to the specified URI with a cancellation token as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. + > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The request message was already sent by the instance. @@ -804,8 +812,11 @@ The is not an absolute URI. is not set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -867,7 +878,7 @@ The is not an absolute URI. 4.1.1.0 - Send a GET request to the specified Uri as an asynchronous operation. + Send a GET request to the specified URI as an asynchronous operation. is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri as an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -988,25 +999,25 @@ The is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri as an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1056,26 +1067,26 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. An HTTP completion option value that indicates when the operation should be considered completed. - Send a GET request to the specified Uri with an HTTP completion option as an asynchronous operation. + Send a GET request to the specified URI with an HTTP completion option as an asynchronous operation. The task object representing the asynchronous operation. object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. + This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -1126,28 +1137,31 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Send a GET request to the specified Uri with a cancellation token as an asynchronous operation. + Send a GET request to the specified URI with a cancellation token as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1193,26 +1207,26 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. An HTTP completion option value that indicates when the operation should be considered completed. - Send a GET request to the specified Uri with an HTTP completion option as an asynchronous operation. + Send a GET request to the specified URI with an HTTP completion option as an asynchronous operation. The task object representing the asynchronous operation. object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. + This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1258,27 +1272,30 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Send a GET request to the specified Uri with a cancellation token as an asynchronous operation. + Send a GET request to the specified URI with a cancellation token as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1329,29 +1346,32 @@ The is not an absolute URI. - The Uri the request is sent to. - An HTTP completion option value that indicates when the operation should be considered completed. + The URI the request is sent to. + An HTTP completion option value that indicates when the operation should be considered completed. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Send a GET request to the specified Uri with an HTTP completion option and a cancellation token as an asynchronous operation. + Send a GET request to the specified URI with an HTTP completion option and a cancellation token as an asynchronous operation. The task object representing the asynchronous operation. object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. + This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1398,28 +1418,31 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. An HTTP completion option value that indicates when the operation should be considered completed. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Send a GET request to the specified Uri with an HTTP completion option and a cancellation token as an asynchronous operation. + Send a GET request to the specified URI with an HTTP completion option and a cancellation token as an asynchronous operation. The task object representing the asynchronous operation. object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. + This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1430,7 +1453,7 @@ The is not an absolute URI. 4.1.1.0 - Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a byte array in an asynchronous operation. is not an absolute URI. - The Uri the request is sent to. - Sends a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation. + The URI the request is sent to. + Sends a GET request to the specified URI and return the response body as a byte array in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -1551,26 +1574,26 @@ The is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI and return the response body as a byte array in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1611,28 +1634,31 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The cancellation token to cancel the operation. - Sends a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation. + Sends a GET request to the specified URI and return the response body as a byte array in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1669,27 +1695,30 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The cancellation token to cancel the operation. - Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a byte array in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1700,7 +1729,7 @@ The is not an absolute URI. 4.1.1.0 - Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a stream in an asynchronous operation. is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI and return the response body as a stream in an asynchronous operation. The task object representing the asynchronous operation. ](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. + This operation doesn't block. The returned [Task\](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read or buffer the response body. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -1821,25 +1850,25 @@ The is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI and return the response body as a stream in an asynchronous operation. The task object representing the asynchronous operation. ](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. + This operation doesn't block. The returned [Task\](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1880,29 +1909,32 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The cancellation token to cancel the operation. - Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a stream in an asynchronous operation. The task object representing the asynchronous operation. ](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. + This operation doesn't block. The returned [Task\](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws an without any inner exception. +> - .NET 5 and later versions throw an that nests a . ]]> - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. + The is . + The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). + The provided request URI is not valid relative or absolute URI. - The is . - The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. - The provided request URI is not valid relative or absolute URI. @@ -1938,27 +1970,30 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The cancellation token to cancel the operation. - Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a stream in an asynchronous operation. The task object representing the asynchronous operation. ](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. + This operation doesn't block. The returned [Task\](xref:System.Threading.Tasks.Task%601) object will complete after the response headers are read. This method does not read nor buffer the response body. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The is . The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1969,12 +2004,12 @@ The is not an absolute URI. 4.1.1.0 - Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a string in an asynchronous operation. @@ -2026,25 +2061,25 @@ The is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI and return the response body as a string in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -2090,25 +2125,25 @@ The is not an absolute URI. - The Uri the request is sent to. - Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation. + The URI the request is sent to. + Send a GET request to the specified URI and return the response body as a string in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2149,28 +2184,31 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The cancellation token to cancel the operation. - Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a string in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The is . The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2207,27 +2245,30 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The cancellation token to cancel the operation. - Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation. + Send a GET request to the specified URI and return the response body as a string in an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response body is read. + This operation doesn't block. The returned object will complete after the whole response body is read. > [!NOTE] > In case of a timeout: > - .NET Framework throws a . -> - .NET Core throws a without any inner exception. -> - .NET 5 and later versions throw a that nests a . +> - .NET Core throws a without any inner exception. +> - .NET 5 and later versions throw a that nests a . ]]> The is . The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2315,15 +2356,15 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. - Sends a PATCH request to a Uri designated as a string as an asynchronous operation. + Sends a PATCH request to a URI designated as a string as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. ]]> @@ -2362,7 +2403,7 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. Sends a PATCH request as an asynchronous operation. The task object representing the asynchronous operation. @@ -2370,7 +2411,7 @@ The is not an absolute URI. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. ]]> @@ -2416,16 +2457,16 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. A cancellation token that can be used by other objects or threads to receive notice of cancellation. - Sends a PATCH request with a cancellation token to a Uri represented as a string as an asynchronous operation. + Sends a PATCH request with a cancellation token to a URI represented as a string as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. ]]> @@ -2466,7 +2507,7 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a PATCH request with a cancellation token as an asynchronous operation. @@ -2475,7 +2516,7 @@ The is not an absolute URI. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. ]]> @@ -2490,12 +2531,12 @@ The is not an absolute URI. 4.1.1.0 - Send a POST request to the specified Uri as an asynchronous operation. + Send a POST request to the specified URI as an asynchronous operation. @@ -2545,26 +2586,26 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. - Send a POST request to the specified Uri as an asynchronous operation. + Send a POST request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -2605,26 +2646,26 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. - Send a POST request to the specified Uri as an asynchronous operation. + Send a POST request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2672,7 +2713,7 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. A cancellation token that can be used by other objects or threads to receive notice of cancellation. Send a POST request with a cancellation token as an asynchronous operation. @@ -2681,20 +2722,23 @@ The is not an absolute URI. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2735,7 +2779,7 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. A cancellation token that can be used by other objects or threads to receive notice of cancellation. Send a POST request with a cancellation token as an asynchronous operation. @@ -2744,19 +2788,22 @@ The is not an absolute URI. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2767,12 +2814,12 @@ The is not an absolute URI. 4.1.1.0 - Send a PUT request to the specified Uri as an asynchronous operation. + Send a PUT request to the specified URI as an asynchronous operation. @@ -2822,26 +2869,26 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. - Send a PUT request to the specified Uri as an asynchronous operation. + Send a PUT request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. @@ -2882,26 +2929,26 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. - Send a PUT request to the specified Uri as an asynchronous operation. + Send a PUT request to the specified URI as an asynchronous operation. The task object representing the asynchronous operation. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -2949,7 +2996,7 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. A cancellation token that can be used by other objects or threads to receive notice of cancellation. Send a PUT request with a cancellation token as an asynchronous operation. @@ -2958,20 +3005,23 @@ The is not an absolute URI. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. The provided request URI is not valid relative or absolute URI. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3012,7 +3062,7 @@ The is not an absolute URI. - The Uri the request is sent to. + The URI the request is sent to. The HTTP request content sent to the server. A cancellation token that can be used by other objects or threads to receive notice of cancellation. Send a PUT request with a cancellation token as an asynchronous operation. @@ -3021,19 +3071,22 @@ The is not an absolute URI. object will complete after the whole response (including content) is read. + This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. ]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3084,7 +3137,7 @@ The custom class derived from does The custom does not override the method. The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, or server certificate validation. - If the exception nests the : + If the exception nests the : The request failed due to timeout. @@ -3138,7 +3191,7 @@ The custom does not override The custom does not override the method. The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, or server certificate validation. - If the exception nests the : + If the exception nests the : The request failed due to timeout. @@ -3192,13 +3245,11 @@ The custom does not override The custom does not override the method. The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, or server certificate validation. - The request was canceled. + The cancellation token was canceled. This exception is stored into the returned task. - -or- +-or- - If the exception nests the : - The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3253,13 +3304,11 @@ The custom does not override The custom does not override the method. The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, or server certificate validation. - The request was canceled. + The cancellation token was canceled. This exception is stored into the returned task. - -or- +-or- - If the exception nests the : - The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3275,7 +3324,7 @@ The custom does not override @@ -3322,13 +3371,13 @@ The custom does not override object will complete once the entire response including content is read. The behavior is the same as if has been explicitly specified. + This operation doesn't block. The returned object will complete once the entire response including content is read. The behavior is the same as if has been explicitly specified. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as , are still thrown synchronously. For the stored exceptions, see the exceptions thrown by . @@ -3337,7 +3386,7 @@ This method stores in the task it returns all non-usage exceptions that the meth The is . The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3383,13 +3432,13 @@ This method stores in the task it returns all non-usage exceptions that the meth object will complete as soon as a response is available or the entire response including content is read. + This operation doesn't block. Depending on the value of the `completionOption` parameter, the returned object will complete as soon as a response is available or the entire response including content is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as , are still thrown synchronously. For the stored exceptions, see the exceptions thrown by . @@ -3398,7 +3447,7 @@ This method stores in the task it returns all non-usage exceptions that the meth The is . The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. + .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3444,13 +3493,13 @@ This method stores in the task it returns all non-usage exceptions that the meth object will complete once the entire response including content is read. The behavior is the same as if has been explicitly specified. + This operation doesn't block. The returned object will complete once the entire response including content is read. The behavior is the same as if has been explicitly specified. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as , are still thrown synchronously. For the stored exceptions, see the exceptions thrown by . @@ -3459,8 +3508,11 @@ This method stores in the task it returns all non-usage exceptions that the meth The is . The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. @@ -3508,13 +3560,13 @@ This method stores in the task it returns all non-usage exceptions that the meth object will complete as soon as a response is available or the entire response including content is read. + This operation doesn't block. Depending on the value of the `completionOption` parameter, the returned object will complete as soon as a response is available or the entire response including content is read. > [!NOTE] > In case of timeout, different exceptions are thrown on different .NET implementations. > - is thrown on all applicable .NET Framework versions. -> - without any inner exception is thrown on all applicable .NET Core versions. -> - that nests a is thrown on .NET 5 and later versions. +> - without any inner exception is thrown on all applicable .NET Core versions. +> - that nests a is thrown on .NET 5 and later versions. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as , are still thrown synchronously. For the stored exceptions, see the exceptions thrown by . @@ -3523,8 +3575,11 @@ This method stores in the task it returns all non-usage exceptions that the meth The is . The request message was already sent by the instance. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. - .NET Core and .NET 5 and later only: The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + The cancellation token was canceled. This exception is stored into the returned task. + +-or- + +.NET Core and .NET 5 and later only: The request failed due to timeout. diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml index 2c11ac7239e..2de7a848831 100644 --- a/xml/System.Net.Http/HttpClientHandler.xml +++ b/xml/System.Net.Http/HttpClientHandler.xml @@ -1044,13 +1044,14 @@ handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousA -or- If using custom not overriding method. - The request was canceled. + The request was canceled. -or- - If the exception nests the : - The request failed due to timeout. - The cancellation token was canceled. This exception is stored into the returned task. + If the exception nests the : + The request failed due to timeout. + + This exception is stored into the returned task. diff --git a/xml/System.Net.Security/NegotiateStream.xml b/xml/System.Net.Security/NegotiateStream.xml index 13676d11884..08248721cb4 100644 --- a/xml/System.Net.Security/NegotiateStream.xml +++ b/xml/System.Net.Security/NegotiateStream.xml @@ -211,8 +211,6 @@ The following code example demonstrates the server side of a client-server conne ## Remarks When you specify `true` for the `leaveStreamOpen` parameter, closing the has no effect on the `innerStream` stream; you must explicitly close `innerStream` when you no longer need it. - - ## Examples The following example demonstrates calling this constructor. This code example is part of a larger example provided for the class. @@ -4367,12 +4365,10 @@ This method reads asynchronously as much data as is available into `buffer` and ]]> - The cancellation token was canceled. This exception is stored into the returned task. - - - is . - - is less than 0. + + is . + + is less than 0. -or- @@ -4381,13 +4377,15 @@ This method reads asynchronously as much data as is available into `buffer` and -or- plus count is greater than the length of . - The write operation failed. + The write operation failed. -or- Encryption is in use, but the data could not be encrypted. - This object has been closed. - Authentication has not occurred. + This object has been closed. + Authentication has not occurred. + The cancellation token was canceled. This exception is stored into the returned task. + @@ -4434,8 +4432,6 @@ This method reads asynchronously as much data as is available into `buffer` and If the underlying stream is a , is in milliseconds and is set to by default so that write operations do not time out. - - ## Examples The following code example demonstrates displaying the value of this property.