Skip to content

Add MemberGroup descriptions (System.N*) #12818

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gewarren merged 5 commits into from
Jul 2, 2026
Merged

Add MemberGroup descriptions (System.N*) #12818

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a5ae7c9
add MemberGroup descriptions
gewarren Jun 26, 2026
c426e40
Apply suggestions from code review
gewarren Jun 27, 2026
4daa2a5
respond to feedback
gewarren Jun 29, 2026
5b4941e
resolve conflict
gewarren Jun 29, 2026
ae3ecbb
Merge generic and non-generic overloads into a single MemberGroup
gewarren Jul 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -190,7 +190,7 @@
<ReturnType>System.Nullable&lt;System.DateTimeOffset&gt;</ReturnType>
</ReturnValue>
<Docs>
<summary>The date at which the file was created.</summary>
<summary>Gets or sets the date on which the file was created.</summary>
<value>The file creation date.</value>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -233,7 +233,7 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>The disposition type for a content body part.</summary>
<summary>Gets or sets the disposition type for a content body part.</summary>
<value>The disposition type.</value>
<remarks>
<format type="text/markdown"><![CDATA[
Expand Down Expand Up @@ -464,7 +464,7 @@
<ReturnType>System.Nullable&lt;System.DateTimeOffset&gt;</ReturnType>
</ReturnValue>
<Docs>
<summary>The date when the file was last modified.</summary>
<summary>Gets or sets the date when the file was last modified.</summary>
<value>The file modification date.</value>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -502,7 +502,7 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>The name for a content body part.</summary>
<summary>Gets or sets the name for a content body part.</summary>
<value>The name for the content body part.</value>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -628,7 +628,7 @@
<ReturnType>System.Nullable&lt;System.DateTimeOffset&gt;</ReturnType>
</ReturnValue>
<Docs>
<summary>The date the file was last read.</summary>
<summary>Gets or sets the date the file was last read.</summary>
<value>The last read date.</value>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -665,7 +665,7 @@
<ReturnType>System.Nullable&lt;System.Int64&gt;</ReturnType>
</ReturnValue>
<Docs>
<summary>The approximate size, in bytes, of the file.</summary>
<summary>Gets or sets the approximate size, in bytes, of the file.</summary>
<value>The approximate size, in bytes.</value>
<remarks>To be added.</remarks>
</Docs>
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Net.Http.Headers/ContentRangeHeaderValue.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -694,7 +694,7 @@ This member is an explicit interface member implementation. It can be used only
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>The range units used.</summary>
<summary>Gets or sets the range units used.</summary>
<value>A <see cref="T:System.String" /> that contains range units.</value>
<remarks>
<format type="text/markdown"><![CDATA[
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Net.Http.Headers/HttpHeaders.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -776,7 +776,7 @@ Values added without validation might be observed when enumerating the collectio
<Docs>
<param name="name">The specified header.</param>
<param name="values">The specified header values.</param>
<summary>Return if a specified header and specified values are stored in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</summary>
<summary>Returns a value that indicates whether a specified header and specified values are stored in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</summary>
<returns>
<see langword="true" /> if the specified header <paramref name="name" /> and <see langword="values" /> are stored in the collection; otherwise <see langword="false" />.</returns>
<remarks>To be added.</remarks>
Expand Down
42 changes: 36 additions & 6 deletions xml/System.Net.Http.Json/HttpClientJsonExtensions.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,11 @@
<remarks>To be added.</remarks>
</Docs>
<Members>
<MemberGroup MemberName="DeleteFromJsonAsync">
<Docs>
<summary>Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation.</summary>
</Docs>
</MemberGroup>
<Member MemberName="DeleteFromJsonAsync">
<MemberSignature Language="C#" Value="public static System.Threading.Tasks.Task&lt;object?&gt; DeleteFromJsonAsync (this System.Net.Http.HttpClient client, string? requestUri, Type type, System.Threading.CancellationToken cancellationToken = default);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Threading.Tasks.Task`1&lt;object&gt; DeleteFromJsonAsync(class System.Net.Http.HttpClient client, string requestUri, class System.Type type, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -786,6 +791,11 @@
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
</Docs>
</Member>
<MemberGroup MemberName="GetFromJsonAsAsyncEnumerable&lt;TValue&gt;">
<Docs>
<summary>Sends an <c>HTTP GET</c> request to the specified <paramref name="requestUri" /> and returns the value that results from deserializing the response body as JSON in an async enumerable operation.</summary>
</Docs>
</MemberGroup>
<Member MemberName="GetFromJsonAsAsyncEnumerable&lt;TValue&gt;">
<MemberSignature Language="C#" Value="public static System.Collections.Generic.IAsyncEnumerable&lt;TValue?&gt; GetFromJsonAsAsyncEnumerable&lt;TValue&gt; (this System.Net.Http.HttpClient client, string? requestUri, System.Threading.CancellationToken cancellationToken = default);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Collections.Generic.IAsyncEnumerable`1&lt;!!TValue&gt; GetFromJsonAsAsyncEnumerable&lt;TValue&gt;(class System.Net.Http.HttpClient client, string requestUri, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -1166,6 +1176,11 @@
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
</Docs>
</Member>
<MemberGroup MemberName="GetFromJsonAsync">
<Docs>
<summary>Sends a GET request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation.</summary>
</Docs>
</MemberGroup>
<Member MemberName="GetFromJsonAsync">
<MemberSignature Language="C#" Value="public static System.Threading.Tasks.Task&lt;object?&gt; GetFromJsonAsync (this System.Net.Http.HttpClient client, string? requestUri, Type type, System.Threading.CancellationToken cancellationToken = default);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Threading.Tasks.Task`1&lt;object&gt; GetFromJsonAsync(class System.Net.Http.HttpClient client, string requestUri, class System.Type type, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -1960,6 +1975,11 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
</Docs>
</Member>
<MemberGroup MemberName="PatchAsJsonAsync&lt;TValue&gt;">
<Docs>
<summary>Sends a PATCH request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
</Docs>
</MemberGroup>
<Member MemberName="PatchAsJsonAsync&lt;TValue&gt;">
<MemberSignature Language="C#" Value="public static System.Threading.Tasks.Task&lt;System.Net.Http.HttpResponseMessage&gt; PatchAsJsonAsync&lt;TValue&gt; (this System.Net.Http.HttpClient client, string? requestUri, TValue value, System.Threading.CancellationToken cancellationToken);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Threading.Tasks.Task`1&lt;class System.Net.Http.HttpResponseMessage&gt; PatchAsJsonAsync&lt;TValue&gt;(class System.Net.Http.HttpClient client, string requestUri, !!TValue value, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -2360,6 +2380,11 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
</Docs>
</Member>
<MemberGroup MemberName="PostAsJsonAsync&lt;TValue&gt;">
<Docs>
<summary>Sends a POST request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
</Docs>
</MemberGroup>
<Member MemberName="PostAsJsonAsync&lt;TValue&gt;">
<MemberSignature Language="C#" Value="public static System.Threading.Tasks.Task&lt;System.Net.Http.HttpResponseMessage&gt; PostAsJsonAsync&lt;TValue&gt; (this System.Net.Http.HttpClient client, string? requestUri, TValue value, System.Threading.CancellationToken cancellationToken);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Threading.Tasks.Task`1&lt;class System.Net.Http.HttpResponseMessage&gt; PostAsJsonAsync&lt;TValue&gt;(class System.Net.Http.HttpClient client, string requestUri, !!TValue value, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -2780,6 +2805,11 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
</Docs>
</Member>
<MemberGroup MemberName="PutAsJsonAsync&lt;TValue&gt;">
<Docs>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
</Docs>
</MemberGroup>
<Member MemberName="PutAsJsonAsync&lt;TValue&gt;">
<MemberSignature Language="C#" Value="public static System.Threading.Tasks.Task&lt;System.Net.Http.HttpResponseMessage&gt; PutAsJsonAsync&lt;TValue&gt; (this System.Net.Http.HttpClient client, string? requestUri, TValue value, System.Threading.CancellationToken cancellationToken);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Threading.Tasks.Task`1&lt;class System.Net.Http.HttpResponseMessage&gt; PutAsJsonAsync&lt;TValue&gt;(class System.Net.Http.HttpClient client, string requestUri, !!TValue value, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -2844,7 +2874,7 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<param name="requestUri">The Uri the request is sent to.</param>
<param name="value">The value to serialize.</param>
<param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
<summary>Send a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<returns>The task object representing the asynchronous operation.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
Expand Down Expand Up @@ -2918,7 +2948,7 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<param name="requestUri">The Uri the request is sent to.</param>
<param name="value">The value to serialize.</param>
<param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
<summary>Send a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<returns>The task object representing the asynchronous operation.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
Expand Down Expand Up @@ -3004,7 +3034,7 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<param name="value">The value to serialize.</param>
<param name="options">Options to control the behavior during serialization. The default options are those specified by <see cref="F:System.Text.Json.JsonSerializerDefaults.Web" />.</param>
<param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
<summary>Send a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<returns>The task object representing the asynchronous operation.</returns>
<remarks>To be added.</remarks>
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
Expand Down Expand Up @@ -3064,7 +3094,7 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<param name="value">The value to serialize.</param>
<param name="jsonTypeInfo">The JsonTypeInfo used to control the serialization behavior.</param>
<param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
<summary>Send a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<returns>The task object representing the asynchronous operation.</returns>
<remarks>To be added.</remarks>
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
Expand Down Expand Up @@ -3138,7 +3168,7 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<param name="value">The value to serialize.</param>
<param name="options">Options to control the behavior during serialization. The default options are those specified by <see cref="F:System.Text.Json.JsonSerializerDefaults.Web" />.</param>
<param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
<summary>Send a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<returns>The task object representing the asynchronous operation.</returns>
<remarks>To be added.</remarks>
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
Expand Down Expand Up @@ -3194,7 +3224,7 @@ This method uses <xref:System.Text.Json.JsonSerializerDefaults.Web?displayProper
<param name="value">The value to serialize.</param>
<param name="jsonTypeInfo">The JsonTypeInfo used to control the serialization behavior.</param>
<param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
<summary>Send a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<summary>Sends a PUT request to the specified Uri containing the <paramref name="value" /> serialized as JSON in the request body.</summary>
<returns>The task object representing the asynchronous operation.</returns>
<remarks>To be added.</remarks>
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
Expand Down
10 changes: 10 additions & 0 deletions xml/System.Net.Http.Json/HttpContentJsonExtensions.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,11 @@
<remarks>To be added.</remarks>
</Docs>
<Members>
<MemberGroup MemberName="ReadFromJsonAsAsyncEnumerable&lt;TValue&gt;">
<Docs>
<summary>Reads the HTTP content and returns the value that results from deserializing the content as JSON in an async enumerable operation.</summary>
</Docs>
</MemberGroup>
<Member MemberName="ReadFromJsonAsAsyncEnumerable&lt;TValue&gt;">
<MemberSignature Language="C#" Value="public static System.Collections.Generic.IAsyncEnumerable&lt;TValue?&gt; ReadFromJsonAsAsyncEnumerable&lt;TValue&gt; (this System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken = default);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Collections.Generic.IAsyncEnumerable`1&lt;!!TValue&gt; ReadFromJsonAsAsyncEnumerable&lt;TValue&gt;(class System.Net.Http.HttpContent content, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down Expand Up @@ -201,6 +206,11 @@
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
</Docs>
</Member>
<MemberGroup MemberName="ReadFromJsonAsync">
<Docs>
<summary>Reads the HTTP content and returns the value that results from deserializing the content as JSON in an asynchronous operation.</summary>
</Docs>
</MemberGroup>
<Member MemberName="ReadFromJsonAsync">
<MemberSignature Language="C#" Value="public static System.Threading.Tasks.Task&lt;object?&gt; ReadFromJsonAsync (this System.Net.Http.HttpContent content, Type type, System.Threading.CancellationToken cancellationToken = default);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Threading.Tasks.Task`1&lt;object&gt; ReadFromJsonAsync(class System.Net.Http.HttpContent content, class System.Type type, valuetype System.Threading.CancellationToken cancellationToken) cil managed" />
Expand Down
5 changes: 5 additions & 0 deletions xml/System.Net.Http.Json/JsonContent.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,11 @@
<remarks>To be added.</remarks>
</Docs>
<Members>
<MemberGroup MemberName="Create">
<Docs>
<summary>Creates a new instance of the <see cref="T:System.Net.Http.Json.JsonContent" /> class that will contain the <paramref name="inputValue" /> serialized as JSON.</summary>
</Docs>
</MemberGroup>
<Member MemberName="Create">
<MemberSignature Language="C#" Value="public static System.Net.Http.Json.JsonContent Create (object? inputValue, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Net.Http.Headers.MediaTypeHeaderValue? mediaType = default);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.Http.Json.JsonContent Create(object inputValue, class System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, class System.Net.Http.Headers.MediaTypeHeaderValue mediaType) cil managed" />
Expand Down
Loading
Loading