diff --git a/xml/System.Net.Http/ByteArrayContent.xml b/xml/System.Net.Http/ByteArrayContent.xml index a2e84f09999..816dc8a58d6 100644 --- a/xml/System.Net.Http/ByteArrayContent.xml +++ b/xml/System.Net.Http/ByteArrayContent.xml @@ -156,10 +156,17 @@ - To be added. - To be added. - To be added. - To be added. + The cancellation token to cancel the operation. + Creates an HTTP content stream for reading. It uses the memory from the as a backing store. + The HTTP content stream. + + + @@ -226,11 +233,18 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The target stream. + Optional information about the transport, like the channel binding token. This parameter can be . + The cancellation token to cancel the operation. + Serializes and writes the byte array provided in the constructor to an HTTP content stream. + + + diff --git a/xml/System.Net.Http/DelegatingHandler.xml b/xml/System.Net.Http/DelegatingHandler.xml index df6a7a407a5..8b1049bd50f 100644 --- a/xml/System.Net.Http/DelegatingHandler.xml +++ b/xml/System.Net.Http/DelegatingHandler.xml @@ -221,11 +221,20 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send to the server. + A cancellation token to cancel operation. + Sends an HTTP request to the inner handler to send to the server. + An HTTP response message. + + method is mainly used by the system and not by applications. When this method is called, it calls the method on the inner handler. + + ]]> + diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml index 2b181b67acf..3262666123a 100644 --- a/xml/System.Net.Http/HttpClient.xml +++ b/xml/System.Net.Http/HttpClient.xml @@ -2686,10 +2686,31 @@ The is not an absolute URI. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + Sends an HTTP request with the specified request. + An HTTP response message. + + + + The is . + The HTTP version is 2.0 or higher or the version policy is set to . + + -or- + +The custom class derived from does not override the method. + + -or- + +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 : + The request failed due to timeout. @@ -2715,11 +2736,32 @@ The is not an absolute URI. - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + 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). + Sends an HTTP request. + The HTTP response message. + + + + The is . + The HTTP version is 2.0 or higher or the version policy is set to . + + -or- + + The custom class derived from does not override the method. + + -or- + +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 : + The request failed due to timeout. @@ -2745,11 +2787,36 @@ The is not an absolute URI. - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + The token to cancel the operation. + Sends an HTTP request with the specified request and cancellation token. + The HTTP response message. + + + + The is . + The HTTP version is 2.0 or higher or the version policy is set to . + + -or- + + The custom class derived from does not override the method. + + -or- + +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. + + -or- + + If the exception nests the : + The request failed due to timeout. @@ -2776,12 +2843,37 @@ The is not an absolute URI. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + 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). + The token to cancel the operation. + Sends an HTTP request with the specified request, completion option and cancellation token. + The HTTP response message. + + + + The is . + The HTTP version is 2.0 or higher or the version policy is set to . + + -or- + + The custom class derived from does not override the method. + + -or- + +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. + + -or- + + If the exception nests the : + The request failed due to timeout. diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml index 1b6173d528e..9ed244df9f7 100644 --- a/xml/System.Net.Http/HttpClientHandler.xml +++ b/xml/System.Net.Http/HttpClientHandler.xml @@ -828,11 +828,34 @@ handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousA - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message. + A cancellation token to cancel the operation. + Creates an instance of based on the information provided in the . + The HTTP response message. + + + + The was . + For HTTP/2 and higher or when requesting version upgrade is enabled by . + + -or- + + If using custom class derived from not overriding method. + + -or- + + If using custom not overriding method. + The request was canceled. + + -or- + + If the exception nests the : + The request failed due to timeout. diff --git a/xml/System.Net.Http/HttpContent.xml b/xml/System.Net.Http/HttpContent.xml index b7f25ab9047..db44e5b6157 100644 --- a/xml/System.Net.Http/HttpContent.xml +++ b/xml/System.Net.Http/HttpContent.xml @@ -88,11 +88,19 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The target stream. + Information about the transport (for example, the channel binding token). This parameter may be . + The cancellation token to cancel the operation. + Serializes the HTTP content into a stream of bytes and copies it to . + + + + The was . @@ -737,9 +745,16 @@ - To be added. - To be added. - To be added. + Serializes the HTTP content and returns a stream that represents the content. + The stream that represents the HTTP content. + + + @@ -764,10 +779,17 @@ - To be added. - To be added. - To be added. - To be added. + The cancellation token to cancel the operation. + Serializes the HTTP content and returns a stream that represents the content. + The stream that represents the HTTP content. + + + @@ -964,11 +986,19 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The target stream. + Information about the transport (for example, the channel binding token). This parameter may be . + The cancellation token to cancel the operation. + When overridden in a derived class, serializes the HTTP content to a stream. Otherwise, throws a . + + + + The method is not overridden in the derived class. diff --git a/xml/System.Net.Http/HttpMessageHandler.xml b/xml/System.Net.Http/HttpMessageHandler.xml index 4f730e0a0e9..3f9176205a6 100644 --- a/xml/System.Net.Http/HttpMessageHandler.xml +++ b/xml/System.Net.Http/HttpMessageHandler.xml @@ -196,11 +196,12 @@ - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + The cancellation token to cancel operation. + When overridden in a derived class, sends an HTTP request with the specified request and cancellation token. Otherwise, throws a . + The HTTP response message. To be added. + The method is not overridden in the derived class. diff --git a/xml/System.Net.Http/HttpMessageInvoker.xml b/xml/System.Net.Http/HttpMessageInvoker.xml index 90ed3048543..92586fbff04 100644 --- a/xml/System.Net.Http/HttpMessageInvoker.xml +++ b/xml/System.Net.Http/HttpMessageInvoker.xml @@ -230,11 +230,30 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + The cancellation token to cancel operation. + Sends an HTTP request with the specified request and cancellation token. + The HTTP response message. + + or methods on the class. + + ]]> + + The was . + For HTTP/2 and higher or when requesting version upgrade is enabled by . + + -or- + + If using custom class derived from not overriding method. + + -or- + + If using custom not overriding method. diff --git a/xml/System.Net.Http/MessageProcessingHandler.xml b/xml/System.Net.Http/MessageProcessingHandler.xml index e39716b183d..251fe4ea6fd 100644 --- a/xml/System.Net.Http/MessageProcessingHandler.xml +++ b/xml/System.Net.Http/MessageProcessingHandler.xml @@ -226,11 +226,18 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send to the server. + A cancellation token that can be used by other objects or threads to receive notice of cancellation. + Sends an HTTP request to the inner handler to send to the server. + The HTTP response message. + + + diff --git a/xml/System.Net.Http/MultipartContent.xml b/xml/System.Net.Http/MultipartContent.xml index 2aee3a22cb0..2b29c753104 100644 --- a/xml/System.Net.Http/MultipartContent.xml +++ b/xml/System.Net.Http/MultipartContent.xml @@ -212,10 +212,19 @@ - To be added. - To be added. - To be added. - To be added. + The cancellation token to cancel the operation. + Serializes the HTTP content to a stream using the multipart/* encoding. + The HTTP content stream that represents the multipart/* encoded HTTP content. + + to use a custom stream that contains an array, with each HTTP content entity and its boundary encoded and serialized to a instance. + +This operation blocks until all of the content has been written to the memory stream. + + ]]> + @@ -434,11 +443,18 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The target stream. + Information about the transport (for example, the channel binding token). This parameter may be . + The cancellation token to cancel the operation. + Serializes the multipart HTTP content to a stream. + + + diff --git a/xml/System.Net.Http/ReadOnlyMemoryContent.xml b/xml/System.Net.Http/ReadOnlyMemoryContent.xml index 6741e9496ae..2f57c60c4b9 100644 --- a/xml/System.Net.Http/ReadOnlyMemoryContent.xml +++ b/xml/System.Net.Http/ReadOnlyMemoryContent.xml @@ -134,11 +134,18 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The target stream. + Information about the transport (for example, the channel binding token). This parameter may be . + The cancellation token to cancel the operation. + Serializes the multipart HTTP content to a stream. + + + diff --git a/xml/System.Net.Http/SocketsHttpHandler.xml b/xml/System.Net.Http/SocketsHttpHandler.xml index e9e0700fdd4..3b11c0f6950 100644 --- a/xml/System.Net.Http/SocketsHttpHandler.xml +++ b/xml/System.Net.Http/SocketsHttpHandler.xml @@ -740,11 +740,20 @@ Draining occurs when a request is cancelled or a response is disposed prior to f - To be added. - To be added. - To be added. - To be added. + The HTTP request message to send. + The cancellation token. + Sends an HTTP request. + The HTTP response message. To be added. +For HTTP/2 and higher or when requesting version upgrade is enabled by . + + -or- + + If using custom class derived from not overriding method. + + -or- + + If using custom not overriding method. diff --git a/xml/System.Net.Http/StreamContent.xml b/xml/System.Net.Http/StreamContent.xml index fb2ecd95a90..c49823b033e 100644 --- a/xml/System.Net.Http/StreamContent.xml +++ b/xml/System.Net.Http/StreamContent.xml @@ -149,10 +149,19 @@ The object calls - To be added. - To be added. - To be added. - To be added. + The cancellation token to cancel the operation. + Writes the HTTP stream content to a memory stream. + The HTTP content stream. + + method buffers the content to a memory stream. Derived classes can override this behavior if there's a better way to retrieve the content as stream. For example, a byte array or a string could use a more efficient mechanism, such as wrapping a read-only around the bytes or string. + + ]]> + @@ -264,11 +273,18 @@ The object calls - To be added. - To be added. - To be added. - To be added. - To be added. + The target stream. + Information about the transport (for example, the channel binding token). This parameter may be . + The cancellation token to cancel the operation. + Serializes the multipart HTTP content to a stream. + + +