diff --git a/src/System.Net.Http.Formatting/PushStreamContent.cs b/src/System.Net.Http.Formatting/PushStreamContent.cs
index a8df4f26..6896e6c3 100644
--- a/src/System.Net.Http.Formatting/PushStreamContent.cs
+++ b/src/System.Net.Http.Formatting/PushStreamContent.cs
@@ -14,7 +14,7 @@ namespace System.Net.Http
{
///
/// Provides an implementation that exposes an output
- /// which can be written to directly. The ability to push data to the output stream differs from the
+ /// which can be written to directly. The ability to push data to the output stream differs from the
/// where data is pulled and not pushed.
///
public class PushStreamContent : HttpContent
@@ -24,8 +24,8 @@ namespace System.Net.Http
///
/// Initializes a new instance of the class. The
/// action is called when an output stream
- /// has become available allowing the action to write to it directly. When the
- /// stream is closed, it will signal to the content that is has completed and the
+ /// has become available allowing the action to write to it directly. When the
+ /// stream is closed, it will signal to the content that it has completed and the
/// HTTP request or response will be completed.
///
/// The action to call when an output stream is available.
@@ -35,10 +35,11 @@ namespace System.Net.Http
}
///
- /// Initializes a new instance of the class.
+ /// Initializes a new instance of the class.
///
- /// The action to call when an output stream is available. The stream is automatically
- /// closed when the return task is completed.
+ /// The action to call when an output stream is available. When the
+ /// output stream is closed or disposed, it will signal to the content that it has completed and the
+ /// HTTP request or response will be completed.
public PushStreamContent(Func onStreamAvailable)
: this(onStreamAvailable, (MediaTypeHeaderValue)null)
{
@@ -47,6 +48,8 @@ namespace System.Net.Http
///
/// Initializes a new instance of the class with the given media type.
///
+ /// The action to call when an output stream is available.
+ /// The value of the Content-Type content header on an HTTP response.
public PushStreamContent(Action onStreamAvailable, string mediaType)
: this(Taskify(onStreamAvailable), new MediaTypeHeaderValue(mediaType))
{
@@ -55,6 +58,10 @@ namespace System.Net.Http
///
/// Initializes a new instance of the class with the given media type.
///
+ /// The action to call when an output stream is available. When the
+ /// output stream is closed or disposed, it will signal to the content that it has completed and the
+ /// HTTP request or response will be completed.
+ /// The value of the Content-Type content header on an HTTP response.
public PushStreamContent(Func onStreamAvailable, string mediaType)
: this(onStreamAvailable, new MediaTypeHeaderValue(mediaType))
{
@@ -63,6 +70,8 @@ namespace System.Net.Http
///
/// Initializes a new instance of the class with the given .
///
+ /// The action to call when an output stream is available.
+ /// The value of the Content-Type content header on an HTTP response.
public PushStreamContent(Action onStreamAvailable, MediaTypeHeaderValue mediaType)
: this(Taskify(onStreamAvailable), mediaType)
{
@@ -71,6 +80,10 @@ namespace System.Net.Http
///
/// Initializes a new instance of the class with the given .
///
+ /// The action to call when an output stream is available. When the
+ /// output stream is closed or disposed, it will signal to the content that it has completed and the
+ /// HTTP request or response will be completed.
+ /// The value of the Content-Type content header on an HTTP response.
public PushStreamContent(Func onStreamAvailable, MediaTypeHeaderValue mediaType)
{
if (onStreamAvailable == null)
@@ -98,8 +111,8 @@ namespace System.Net.Http
}
///
- /// When this method is called, it calls the action provided in the constructor with the output
- /// stream to write to. Once the action has completed its work it closes the stream which will
+ /// When this method is called, it calls the action provided in the constructor with the output
+ /// stream to write to. Once the action has completed its work it closes the stream which will
/// close this content instance and complete the HTTP request or response.
///
/// The to which to write.
@@ -142,8 +155,8 @@ namespace System.Net.Http
#if NETFX_CORE
[SuppressMessage(
- "Microsoft.Usage",
- "CA2215:Dispose methods should call base class dispose",
+ "Microsoft.Usage",
+ "CA2215:Dispose methods should call base class dispose",
Justification = "See comments, this is intentional.")]
protected override void Dispose(bool disposing)
{