8000 SocketsHttpHandler - update documentation by aik-jahoda · Pull Request #4290 · dotnet/dotnet-api-docs · GitHub
[go: up one dir, main page]
Skip to content

SocketsHttpHandler - update documentation #4290

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
merged 12 commits into from
Jun 30, 2020
Merged

SocketsHttpHandler - update documentation #4290

Changes from 5 commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
380dc75
Add ctor doc
May 27, 2020
e0f8433
AllowAutoRedirect doc
May 27, 2020
2e52825
Connect timeout doc
May 27, 2020
db7919f
Credentials doc
May 27, 2020
4d5f05f
SocketsHttpHandler.Expect100ContinueTimeout doc
May 27, 2020
a8a8fa5
Update xml/System.Net.Http/SocketsHttpHandler.xml
aik-jahoda Jun 3, 2020
e6c7ee5
Merge branch 'jajahoda/SocketsHttpHandler' of github.com:aik-jahoda/d…
Jun 9, 2020
23cda33
Apply suggestions from code review
aik-jahoda Jun 10, 2020
e6faf18
Documentation
Jun 10, 2020
c48e8a0
Merge branch 'jajahoda/SocketsHttpHandler' of github.com:aik-jahoda/d…
Jun 10, 2020
8053a82
Update xml/System.Net.Http/SocketsHttpHandler.xml
aik-jahoda Jun 26, 2020
63fe72a
RP comments
Jun 26, 2020
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
32 changes: 24 additions & 8 deletions xml/System.Net.Http/SocketsHttpHandler.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ If this change is undesirable, you can configure your application to use the old
</AssemblyInfo>
<Parameters />
<Docs>
<summary>To be added.</summary>
<summary>Creates an instance of a <see cref="T:System.Net.Http.SocketsHttpHandler" /> class.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand All @@ -92,9 +92,25 @@ If this change is undesirable, you can configure your application to use the old
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Gets or sets a value that indicates whether the handler should follow redirection responses.</summary>
<value>
<see langword="true" /> if the handler should follow redirection responses; otherwise <see langword="false" />. The default value is <see langword="true" />.
</value>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
Set <xref:System.Net.Http.SocketsHttpHandler.AllowAutoRedirect%2A> to `true` if you want the handler to automatically follow HTTP redirection headers to the new location of the resource. The maximum number of redirections to follow is set by the <xref:System.Net.Http.SocketsHttpHandler.MaxAutomaticRedirections%2A> property.

If <xref:System.Net.Http.SocketsHttpHandler.AllowAutoRedirect%2A> is set to `false`, all HTTP responses with an HTTP status code from 300 to 399 are returned to the application.

The Authorization header is cleared on auto-redirects and the handler automatically tries to re-authenticate to the redirected location. In practice, this means that an application can't put custom authentication information into the Authorization header if it is possible to encounter redirection. Instead, the application must implement and register a custom authentication module.

> [!NOTE]
> Handler never follow a redirection from HTTPS to HTTP even if <xref:System.Net.Http.SocketsHttpHandler.AllowAutoRedirect%2A> is set to `true`.

]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="AutomaticDecompression">
Expand Down Expand Up @@ -138,8 +154,8 @@ If this change is undesirable, you can configure your application to use the old
<ReturnType>System.TimeSpan</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<summary>Gets or sets the timespan to wait before the connection establishing times out.</summary>
<value>The timespan to wait before the connection establishing times out. The default value is <xref:Timeout.InfiniteTimeSpan?displayProperty=nameWithType>.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down 73AD Expand Up @@ -184,8 +200,8 @@ If this change is undesirable, you can configure your application to use the old
<ReturnType>System.Net.ICredentials</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<summary>Gets or sets authentication information used by this handler.</summary>
<value>The authentication credentials associated with the handler. The default is <see langword="null" />.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down
0