System.Net.WebSockets.xml 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Net.WebSockets</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Net.WebSockets.WebSocket">
  8. <summary>The WebSocket class allows applications to send and receive data after the WebSocket upgrade has completed.</summary>
  9. </member>
  10. <member name="M:System.Net.WebSockets.WebSocket.#ctor">
  11. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocket" /> class.</summary>
  12. </member>
  13. <member name="M:System.Net.WebSockets.WebSocket.Abort">
  14. <summary>Aborts the WebSocket connection and cancels any pending IO operations.</summary>
  15. </member>
  16. <member name="M:System.Net.WebSockets.WebSocket.CloseAsync(System.Net.WebSockets.WebSocketCloseStatus,System.String,System.Threading.CancellationToken)">
  17. <summary>Closes the WebSocket connection as an asynchronous operation using the close handshake defined in the WebSocket protocol specification section 7.</summary>
  18. <returns>Returns <see cref="T:System.Threading.Tasks.Task" />.The task object representing the asynchronous operation. </returns>
  19. <param name="closeStatus">Indicates the reason for closing the WebSocket connection.</param>
  20. <param name="statusDescription">Specifies a human readable explanation as to why the connection is closed.</param>
  21. <param name="cancellationToken">The token that can be used to propagate notification that operations should be canceled.</param>
  22. </member>
  23. <member name="M:System.Net.WebSockets.WebSocket.CloseOutputAsync(System.Net.WebSockets.WebSocketCloseStatus,System.String,System.Threading.CancellationToken)">
  24. <summary>Initiates or completes the close handshake defined in the WebSocket protocol specification section 7.</summary>
  25. <returns>Returns <see cref="T:System.Threading.Tasks.Task" />.The task object representing the asynchronous operation. </returns>
  26. <param name="closeStatus">Indicates the reason for closing the WebSocket connection.</param>
  27. <param name="statusDescription">Allows applications to specify a human readable explanation as to why the connection is closed.</param>
  28. <param name="cancellationToken">The token that can be used to propagate notification that operations should be canceled.</param>
  29. </member>
  30. <member name="P:System.Net.WebSockets.WebSocket.CloseStatus">
  31. <summary>Indicates the reason why the remote endpoint initiated the close handshake.</summary>
  32. <returns>Returns <see cref="T:System.Net.WebSockets.WebSocketCloseStatus" />.</returns>
  33. </member>
  34. <member name="P:System.Net.WebSockets.WebSocket.CloseStatusDescription">
  35. <summary>Allows the remote endpoint to describe the reason why the connection was closed.</summary>
  36. <returns>Returns <see cref="T:System.String" />.</returns>
  37. </member>
  38. <member name="M:System.Net.WebSockets.WebSocket.Dispose">
  39. <summary>Used to clean up unmanaged resources for ASP.NET and self-hosted implementations.</summary>
  40. </member>
  41. <member name="M:System.Net.WebSockets.WebSocket.ReceiveAsync(System.ArraySegment{System.Byte},System.Threading.CancellationToken)">
  42. <summary>Receives data from the WebSocket connection asynchronously.</summary>
  43. <returns>Returns <see cref="T:System.Threading.Tasks.Task`1" />.The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the received data.</returns>
  44. <param name="buffer">References the application buffer that is the storage location for the received data.</param>
  45. <param name="cancellationToken">Propagate the notification that operations should be canceled.</param>
  46. </member>
  47. <member name="M:System.Net.WebSockets.WebSocket.SendAsync(System.ArraySegment{System.Byte},System.Net.WebSockets.WebSocketMessageType,System.Boolean,System.Threading.CancellationToken)">
  48. <summary>Sends data over the WebSocket connection asynchronously.</summary>
  49. <returns>Returns <see cref="T:System.Threading.Tasks.Task" />.The task object representing the asynchronous operation. </returns>
  50. <param name="buffer">The buffer to be sent over the connection.</param>
  51. <param name="messageType">Indicates whether the application is sending a binary or text message.</param>
  52. <param name="endOfMessage">Indicates whether the data in “buffer” is the last part of a message.</param>
  53. <param name="cancellationToken">The token that propagates the notification that operations should be canceled.</param>
  54. </member>
  55. <member name="P:System.Net.WebSockets.WebSocket.State">
  56. <summary>Returns the current state of the WebSocket connection.</summary>
  57. <returns>Returns <see cref="T:System.Net.WebSockets.WebSocketState" />.</returns>
  58. </member>
  59. <member name="P:System.Net.WebSockets.WebSocket.SubProtocol">
  60. <summary>The subprotocol that was negotiated during the opening handshake.</summary>
  61. <returns>Returns <see cref="T:System.String" />.</returns>
  62. </member>
  63. <member name="T:System.Net.WebSockets.WebSocketCloseStatus">
  64. <summary>Represents well known WebSocket close codes as defined in section 11.7 of the WebSocket protocol spec.</summary>
  65. </member>
  66. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.Empty">
  67. <summary>No error specified.</summary>
  68. </member>
  69. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.EndpointUnavailable">
  70. <summary>(1001) Indicates an endpoint is being removed. Either the server or client will become unavailable.</summary>
  71. </member>
  72. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.InternalServerError">
  73. <summary>The connection will be closed by the server because of an error on the server.</summary>
  74. </member>
  75. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.InvalidMessageType">
  76. <summary>(1003) The client or server is terminating the connection because it cannot accept the data type it received.</summary>
  77. </member>
  78. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.InvalidPayloadData">
  79. <summary>(1007) The client or server is terminating the connection because it has received data inconsistent with the message type.</summary>
  80. </member>
  81. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.MandatoryExtension">
  82. <summary>(1010) The client is terminating the connection because it expected the server to negotiate an extension.</summary>
  83. </member>
  84. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.MessageTooBig">
  85. <summary>(1004) Reserved for future use.</summary>
  86. </member>
  87. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.NormalClosure">
  88. <summary>(1000) The connection has closed after the request was fulfilled.</summary>
  89. </member>
  90. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.PolicyViolation">
  91. <summary>(1008) The connection will be closed because an endpoint has received a message that violates its policy.</summary>
  92. </member>
  93. <member name="F:System.Net.WebSockets.WebSocketCloseStatus.ProtocolError">
  94. <summary>(1002) The client or server is terminating the connection because of a protocol error.</summary>
  95. </member>
  96. <member name="T:System.Net.WebSockets.WebSocketError">
  97. <summary>Contains the list of possible WebSocket errors.</summary>
  98. </member>
  99. <member name="F:System.Net.WebSockets.WebSocketError.ConnectionClosedPrematurely">
  100. <summary>Indicates that the connection was terminated unexpectedly.</summary>
  101. </member>
  102. <member name="F:System.Net.WebSockets.WebSocketError.Faulted">
  103. <summary>Indicates a general error.</summary>
  104. </member>
  105. <member name="F:System.Net.WebSockets.WebSocketError.HeaderError">
  106. <summary>Indicates an error occurred when parsing the HTTP headers during the opening handshake.</summary>
  107. </member>
  108. <member name="F:System.Net.WebSockets.WebSocketError.InvalidMessageType">
  109. <summary>Indicates that a WebSocket frame with an unknown opcode was received.</summary>
  110. </member>
  111. <member name="F:System.Net.WebSockets.WebSocketError.InvalidState">
  112. <summary>Indicates the WebSocket is an invalid state for the given operation (such as being closed or aborted).</summary>
  113. </member>
  114. <member name="F:System.Net.WebSockets.WebSocketError.NativeError">
  115. <summary>Indicates that an unknown native error occurred.</summary>
  116. </member>
  117. <member name="F:System.Net.WebSockets.WebSocketError.NotAWebSocket">
  118. <summary>Indicates that the incoming request was not a valid websocket request.</summary>
  119. </member>
  120. <member name="F:System.Net.WebSockets.WebSocketError.Success">
  121. <summary>Indicates that there was no native error information for the exception.</summary>
  122. </member>
  123. <member name="F:System.Net.WebSockets.WebSocketError.UnsupportedProtocol">
  124. <summary>Indicates that the client requested an unsupported WebSocket subprotocol.</summary>
  125. </member>
  126. <member name="F:System.Net.WebSockets.WebSocketError.UnsupportedVersion">
  127. <summary>Indicates that the client requested an unsupported version of the WebSocket protocol.</summary>
  128. </member>
  129. <member name="T:System.Net.WebSockets.WebSocketException">
  130. <summary>Represents an exception that occurred when performing an operation on a WebSocket connection.</summary>
  131. </member>
  132. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Int32)">
  133. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  134. <param name="nativeError">The native error code for the exception.</param>
  135. </member>
  136. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Int32,System.Exception)">
  137. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  138. <param name="nativeError">The native error code for the exception.</param>
  139. <param name="innerException">Indicates the previous exception that led to the current exception.</param>
  140. </member>
  141. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Int32,System.String)">
  142. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  143. <param name="nativeError">The native error code for the exception.</param>
  144. <param name="message">The description of the error.</param>
  145. </member>
  146. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError)">
  147. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  148. <param name="error">The error from the WebSocketError enumeration.</param>
  149. </member>
  150. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.Exception)">
  151. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  152. <param name="error">The error from the WebSocketError enumeration.</param>
  153. <param name="innerException">Indicates the previous exception that led to the current exception.</param>
  154. </member>
  155. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.Int32)">
  156. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  157. <param name="error">The error from the WebSocketError enumeration.</param>
  158. <param name="nativeError">The native error code for the exception.</param>
  159. </member>
  160. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.Int32,System.Exception)">
  161. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  162. <param name="error">The error from the WebSocketError enumeration.</param>
  163. <param name="nativeError">The native error code for the exception.</param>
  164. <param name="innerException">Indicates the previous exception that led to the current exception.</param>
  165. </member>
  166. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.Int32,System.String)">
  167. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  168. <param name="error">The error from the WebSocketError enumeration.</param>
  169. <param name="nativeError">The native error code for the exception.</param>
  170. <param name="message">The description of the error.</param>
  171. </member>
  172. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.Int32,System.String,System.Exception)">
  173. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  174. <param name="error">The error from the WebSocketError enumeration.</param>
  175. <param name="nativeError">The native error code for the exception.</param>
  176. <param name="message">The description of the error.</param>
  177. <param name="innerException">Indicates the previous exception that led to the current exception.</param>
  178. </member>
  179. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.String)">
  180. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  181. <param name="error">The error from the WebSocketError enumeration.</param>
  182. <param name="message">The description of the error.</param>
  183. </member>
  184. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.Net.WebSockets.WebSocketError,System.String,System.Exception)">
  185. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  186. <param name="error">The error from the WebSocketError enumeration.</param>
  187. <param name="message">The description of the error.</param>
  188. <param name="innerException">Indicates the previous exception that led to the current exception.</param>
  189. </member>
  190. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.String)">
  191. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  192. <param name="message">The description of the error.</param>
  193. </member>
  194. <member name="M:System.Net.WebSockets.WebSocketException.#ctor(System.String,System.Exception)">
  195. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketException" /> class.</summary>
  196. <param name="message">The description of the error.</param>
  197. <param name="innerException">Indicates the previous exception that led to the current exception.</param>
  198. </member>
  199. <member name="P:System.Net.WebSockets.WebSocketException.ErrorCode">
  200. <summary>The native error code for the exception that occurred.</summary>
  201. <returns>Returns <see cref="T:System.Int32" />.</returns>
  202. </member>
  203. <member name="P:System.Net.WebSockets.WebSocketException.WebSocketErrorCode">
  204. <summary>Returns a WebSocketError indicating the type of error that occurred.</summary>
  205. <returns>Returns <see cref="T:System.Net.WebSockets.WebSocketError" />.</returns>
  206. </member>
  207. <member name="T:System.Net.WebSockets.WebSocketMessageType">
  208. <summary>Indicates the message type.</summary>
  209. </member>
  210. <member name="F:System.Net.WebSockets.WebSocketMessageType.Binary">
  211. <summary>The message is in binary format.</summary>
  212. </member>
  213. <member name="F:System.Net.WebSockets.WebSocketMessageType.Close">
  214. <summary>A receive has completed because a close message was received.</summary>
  215. </member>
  216. <member name="F:System.Net.WebSockets.WebSocketMessageType.Text">
  217. <summary>The message is clear text.</summary>
  218. </member>
  219. <member name="T:System.Net.WebSockets.WebSocketReceiveResult">
  220. <summary>An instance of this class represents the result of performing a single ReceiveAsync operation on a WebSocket.</summary>
  221. </member>
  222. <member name="M:System.Net.WebSockets.WebSocketReceiveResult.#ctor(System.Int32,System.Net.WebSockets.WebSocketMessageType,System.Boolean)">
  223. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketReceiveResult" /> class.</summary>
  224. <param name="count">The number of bytes received.</param>
  225. <param name="messageType">The type of message that was received.</param>
  226. <param name="endOfMessage">Indicates whether this is the final message.</param>
  227. </member>
  228. <member name="M:System.Net.WebSockets.WebSocketReceiveResult.#ctor(System.Int32,System.Net.WebSockets.WebSocketMessageType,System.Boolean,System.Nullable{System.Net.WebSockets.WebSocketCloseStatus},System.String)">
  229. <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketReceiveResult" /> class.</summary>
  230. <param name="count">The number of bytes received.</param>
  231. <param name="messageType">The type of message that was received.</param>
  232. <param name="endOfMessage">Indicates whether this is the final message.</param>
  233. <param name="closeStatus">Indicates the <see cref="T:System.Net.WebSockets.WebSocketCloseStatus" /> of the connection.</param>
  234. <param name="closeStatusDescription">The description of <paramref name="closeStatus" />.</param>
  235. </member>
  236. <member name="P:System.Net.WebSockets.WebSocketReceiveResult.CloseStatus">
  237. <summary>Indicates the reason why the remote endpoint initiated the close handshake.</summary>
  238. <returns>Returns <see cref="T:System.Net.WebSockets.WebSocketCloseStatus" />.</returns>
  239. </member>
  240. <member name="P:System.Net.WebSockets.WebSocketReceiveResult.CloseStatusDescription">
  241. <summary>Returns the optional description that describes why the close handshake has been initiated by the remote endpoint.</summary>
  242. <returns>Returns <see cref="T:System.String" />.</returns>
  243. </member>
  244. <member name="P:System.Net.WebSockets.WebSocketReceiveResult.Count">
  245. <summary>Indicates the number of bytes that the WebSocket received.</summary>
  246. <returns>Returns <see cref="T:System.Int32" />.</returns>
  247. </member>
  248. <member name="P:System.Net.WebSockets.WebSocketReceiveResult.EndOfMessage">
  249. <summary>Indicates whether the message has been received completely.</summary>
  250. <returns>Returns <see cref="T:System.Boolean" />.</returns>
  251. </member>
  252. <member name="P:System.Net.WebSockets.WebSocketReceiveResult.MessageType">
  253. <summary>Indicates whether the current message is a UTF-8 message or a binary message.</summary>
  254. <returns>Returns <see cref="T:System.Net.WebSockets.WebSocketMessageType" />.</returns>
  255. </member>
  256. <member name="T:System.Net.WebSockets.WebSocketState">
  257. <summary> Defines the different states a WebSockets instance can be in.</summary>
  258. </member>
  259. <member name="F:System.Net.WebSockets.WebSocketState.Aborted">
  260. <summary>Reserved for future use.</summary>
  261. </member>
  262. <member name="F:System.Net.WebSockets.WebSocketState.Closed">
  263. <summary>Indicates the WebSocket close handshake completed gracefully.</summary>
  264. </member>
  265. <member name="F:System.Net.WebSockets.WebSocketState.CloseReceived">
  266. <summary>A close message was received from the remote endpoint.</summary>
  267. </member>
  268. <member name="F:System.Net.WebSockets.WebSocketState.CloseSent">
  269. <summary>A close message was sent to the remote endpoint.</summary>
  270. </member>
  271. <member name="F:System.Net.WebSockets.WebSocketState.Connecting">
  272. <summary>The connection is negotiating the handshake with the remote endpoint.</summary>
  273. </member>
  274. <member name="F:System.Net.WebSockets.WebSocketState.None">
  275. <summary>Reserved for future use.</summary>
  276. </member>
  277. <member name="F:System.Net.WebSockets.WebSocketState.Open">
  278. <summary>The initial state after the HTTP handshake has been completed.</summary>
  279. </member>
  280. </members>
  281. </doc>