Skip to content

HttpContent: Buffering is implementation dependent #10108

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.

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
merged 4 commits into from
Jul 19, 2024

Conversation

breyed
Copy link
Contributor

@breyed breyed commented Jul 13, 2024

For ReadAsStreamAsync, corrects the documentation to indicate that waiting for the content to be buffered prior to task completion is conditional based on implementation.

For ReadAsStreamAsync and ReadAsStream, gives an example of a common implementation that conditionally buffers.

Per a comment by @stephentoub, this area of documentation could stand improvement. This commit appears to be the first step in doing so.

Summary

Describe your changes here.

Fixes #Issue_Number (if available)

For `ReadAsStreamAsync`, corrects the documentation to indicate that waiting for the content to be buffered prior to task completion is conditional based on implementation.

For `ReadAsStreamAsync` and `ReadAsStream`, gives an example of a common implementation that conditionally buffers.

Per a [comment](dotnet/runtime#31316 (comment)) by @stephentoub, this area of documentation could stand improvement. This commit appears to be the first step in doing so.
@breyed breyed requested a review from a team as a code owner July 13, 2024 23:52
@ghost ghost added the area-System.Net.Http label Jul 13, 2024
@dotnet-policy-service dotnet-policy-service bot added the community-contribution Indicates that the PR has been added by a community member label Jul 13, 2024
Copy link
Contributor

Tagging subscribers to this area: @dotnet/ncl

This comment was marked as outdated.

breyed and others added 2 commits July 14, 2024 06:57
Co-authored-by: Günther Foidl <[email protected]>
Co-authored-by: Günther Foidl <[email protected]>

This comment was marked as outdated.

Copy link

Learn Build status updates of commit 98e56cd:

⚠️ Validation status: warnings

File Status Preview URL Details
xml/System.Net.Http/HttpContent.xml ⚠️Warning View Details

xml/System.Net.Http/HttpContent.xml

  • Line 0, Column 0: [Warning: disallowed-html-tag - See documentation] HTML tag 'see' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
  • Line 0, Column 0: [Warning: disallowed-html-tag - See documentation] HTML tag 'see' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
  • Line 0, Column 0: [Warning: disallowed-html-tag - See documentation] HTML tag 'see' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
  • Line 0, Column 0: [Warning: disallowed-html-tag - See documentation] HTML tag 'see' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
  • Line 0, Column 0: [Warning: disallowed-html-tag - See documentation] HTML tag 'see' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
  • Line 0, Column 0: [Warning: disallowed-html-tag - See documentation] HTML tag 'see' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@gewarren gewarren enabled auto-merge (squash) July 19, 2024 22:57
Copy link

Learn Build status updates of commit a7a2535:

✅ Validation status: passed

File Status Preview URL Details
xml/System.Net.Http/HttpContent.xml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@gewarren gewarren merged commit 9714891 into dotnet:main Jul 19, 2024
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-System.Net.Http community-contribution Indicates that the PR has been added by a community member
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants