Adding documentation for System.Net.WebSockets APIs released in 3.0 (#2830)

* Adding documentation for System.Net.WebSockets APIs released in 3.0

* Update ClientWebSocket.xml

* Removing double spaces

Author: jozkee

xml/System.Net.WebSockets/ClientWebSocket.xml

@@ -433,7 +433,7 @@
       </Parameters>
       <Docs>
         <param name="buffer">The buffer to receive the response.</param>
-        <param name="cancellationToken">A cancellation token used to propagate notification that this  operation should be canceled.</param>
+        <param name="cancellationToken">A cancellation token used to propagate notification that this operation should be canceled.</param>
         <summary>Receives data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> as an asynchronous operation.</summary>
         <returns>The task object representing the asynchronous operation.</returns>
         <remarks>
@@ -446,6 +446,8 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> is not connected.</exception>
+        <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> has been closed.</exception>
       </Docs>
     </Member>
     <Member MemberName="ReceiveAsync">
@@ -473,11 +475,22 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="1" FrameworkAlternate="netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="buffer">The region of memory to receive the response.</param>
+        <param name="cancellationToken">A cancellation token used to propagate notification that this operation should be canceled.</param>
+        <summary>Receives data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> to a byte memory range as an asynchronous operation.</summary>
+        <returns>The task object representing the asynchronous operation.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+ This operation will not block. The returned <xref:System.Threading.Tasks.Task%601> object will complete after the receive request on the <xref:System.Net.WebSockets.ClientWebSocket> instance has completed.  
+  
+ Exactly one send and one receive is supported on each <xref:System.Net.WebSockets.ClientWebSocket> object in parallel.  
+  
+ ]]></format>
+        </remarks>
+        <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> is not connected.</exception>
+        <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> has been closed.</exception>
       </Docs>
     </Member>
     <Member MemberName="SendAsync">
@@ -514,21 +527,24 @@
       </Parameters>
       <Docs>
         <param name="buffer">The buffer containing the message to be sent.</param>
-        <param name="messageType">Specifies whether the buffer is clear text or in a binary format.</param>
-        <param name="endOfMessage">Specifies whether this is the final asynchronous send. Set to <see langword="true" /> if this is the final send; <see langword="false" /> otherwise.</param>
-        <param name="cancellationToken">A cancellation token used to propagate notification that this  operation should be canceled.</param>
-        <summary>Send data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> as an asynchronous operation.</summary>
+        <param name="messageType">One of the enumeration values that specifies whether the buffer is clear text or in a binary format.</param>
+        <param name="endOfMessage"><see langword="true" /> to indicate this is the final asynchronous send; otherwise, <see langword="false" />.</param>
+        <param name="cancellationToken">A cancellation token used to propagate notification that this operation should be canceled.</param>
+        <summary>Sends data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> as an asynchronous operation.</summary>
         <returns>The task object representing the asynchronous operation.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
-## Remarks  
+## Remarks
+
  This operation will not block. The returned <xref:System.Threading.Tasks.Task> object will complete after the send request on the <xref:System.Net.WebSockets.ClientWebSocket> instance has completed.  
   
  Exactly one send and one receive is supported on each <xref:System.Net.WebSockets.ClientWebSocket> object in parallel.  
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> is not connected.</exception>
+        <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> has been closed.</exception>
       </Docs>
     </Member>
     <Member MemberName="SendAsync">
@@ -558,13 +574,25 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="3" FrameworkAlternate="netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <param name="messageType">To be added.</param>
-        <param name="endOfMessage">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="buffer">The region of memory containing the message to be sent.</param>
+        <param name="messageType">One of the enumeration values that specifies whether the buffer is clear text or in a binary format.</param>
+        <param name="endOfMessage"><see langword="true" /> to indicate this is the final asynchronous send; otherwise, <see langword="false" />.</param>
+        <param name="cancellationToken">A cancellation token used to propagate notification that this operation should be canceled.</param>
+        <summary>Sends data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> from a read-only byte memory range as an asynchronous operation.</summary>
+        <returns>The task object representing the asynchronous operation.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks
+
+This operation will not block. The returned <xref:System.Threading.Tasks.Task> object will complete after the send request on the <xref:System.Net.WebSockets.ClientWebSocket> instance has completed.
+  
+Exactly one send and one receive is supported on each <xref:System.Net.WebSockets.ClientWebSocket> object in parallel.
+  
+ ]]></format>
+        </remarks>
+        <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> is not connected.</exception>
+        <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.WebSockets.ClientWebSocket" /> has been closed.</exception>
       </Docs>
     </Member>
     <Member MemberName="State">
@@ -634,4 +662,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>