pr feedback

This commit is contained in:
Andrew Stanton-Nurse 2019-02-26 15:42:06 -08:00
parent 8c2c458891
commit 22e706cdc3
2 changed files with 10 additions and 14 deletions

View File

@ -64,11 +64,12 @@ namespace Microsoft.AspNetCore.SignalR.Client
private int _serverProtocolMinorVersion;
/// <summary>
/// Occurs when the connection is closed, either by a call to <see cref="StopAsync(CancellationToken)"/> or a connection error.
/// Occurs when the connection is closed. The connection could be closed due to an error or due to either the server or client intentionally
/// closing the connection without error.
/// </summary>
/// <remarks>
/// If this event was triggered from a connection error, the <see cref="Exception"/> that occurred will be passed in as the
/// sole argument to this handler. If this event was triggered from a call to <see cref="StopAsync(CancellationToken)"/>, then
/// sole argument to this handler. If this event was triggered intentionally by either the client or server, then
/// the argument will be <see langword="null"/>.
/// </remarks>
/// <example>
@ -76,7 +77,8 @@ namespace Microsoft.AspNetCore.SignalR.Client
/// if there was an error:
///
/// <code>
/// connection.Closed += (exception) => {
/// connection.Closed += (exception) =>
/// {
/// if (exception == null)
/// {
/// Console.WriteLine("Connection closed without error.");
@ -1010,17 +1012,11 @@ namespace Microsoft.AspNetCore.SignalR.Client
}
}
/// <summary>
/// This method is for internal framework use and should not be called by user code.
/// </summary>
public void ResetSendPing()
{
Volatile.Write(ref _nextActivationSendPing, (DateTime.UtcNow + KeepAliveInterval).Ticks);
}
/// <summary>
/// This method is for internal framework use and should not be called by user code.
/// </summary>
public void ResetTimeout()
{
Volatile.Write(ref _nextActivationServerTimeout, (DateTime.UtcNow + ServerTimeout).Ticks);

View File

@ -13,7 +13,7 @@ namespace Microsoft.AspNetCore.Http.Connections
/// Gets the <see cref="HttpContext"/> associated with the connection, if there is one.
/// </summary>
/// <param name="connection">The <see cref="ConnectionContext"/> representing the connection.</param>
/// <returns>The <see cref="HttpContext"/> associated with the connection, or <see langword="null"/> if the connection is not HTTP-based</returns>
/// <returns>The <see cref="HttpContext"/> associated with the connection, or <see langword="null"/> if the connection is not HTTP-based.</returns>
/// <remarks>
/// SignalR connections can run on top of HTTP transports like WebSockets or Long Polling, or other non-HTTP transports. As a result,
/// this method can sometimes return <see langword="null"/> depending on the configuration of your application.