Microsoft.Threading.Tasks.Extensions.xml 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Microsoft.Threading.Tasks.Extensions</name>
  5. </assembly>
  6. <members>
  7. <member name="M:System.Threading.Tasks.TaskServices.FromCancellation(System.Threading.CancellationToken)">
  8. <summary>Returns a canceled task.</summary>
  9. <param name="cancellationToken">The cancellation token.</param>
  10. <returns>The canceled task.</returns>
  11. </member>
  12. <member name="M:System.Threading.Tasks.TaskServices.FromCancellation``1(System.Threading.CancellationToken)">
  13. <summary>Returns a canceled task.</summary>
  14. <typeparam name="TResult">Specifies the type of the result.</typeparam>
  15. <param name="cancellationToken">The cancellation token.</param>
  16. <returns>The canceled task.</returns>
  17. </member>
  18. <member name="M:System.Threading.Tasks.TaskServices.HandleEapCompletion``1(System.Threading.Tasks.TaskCompletionSource{``0},System.Boolean,System.ComponentModel.AsyncCompletedEventArgs,System.Func{``0},System.Action)">
  19. <summary>
  20. Completes the Task if the user state matches the TaskCompletionSource.
  21. </summary>
  22. <typeparam name="T">Specifies the type of data returned by the Task.</typeparam>
  23. <param name="tcs">The TaskCompletionSource.</param>
  24. <param name="e">The completion event arguments.</param>
  25. <param name="requireMatch">Whether we require the tcs to match the e.UserState.</param>
  26. <param name="getResult">A function that gets the result with which to complete the task.</param>
  27. <param name="unregisterHandler">An action used to unregister work when the operaiton completes.</param>
  28. </member>
  29. <member name="T:AsyncExtensions">
  30. <summary>
  31. Provides asynchronous wrappers for .NET Framework operations.
  32. </summary>
  33. </member>
  34. <member name="M:AsyncExtensions.ReadAsync(System.IO.Stream,System.Byte[],System.Int32,System.Int32)">
  35. <summary>
  36. Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.
  37. </summary>
  38. <returns>A Task that represents the asynchronous read.</returns>
  39. <param name="source">The source.</param>
  40. <param name="buffer">The buffer to read data into. </param>
  41. <param name="offset">The byte offset in at which to begin reading. </param>
  42. <param name="count">The maximum number of bytes to read. </param>
  43. <exception cref="T:System.ArgumentException">The array length minus is less than <paramref name="count" />. </exception>
  44. <exception cref="T:System.ArgumentNullException"> is null. </exception>
  45. <exception cref="T:System.ArgumentOutOfRangeException"> or <paramref name="count" /> is negative. </exception>
  46. <exception cref="T:System.IO.IOException">An asynchronous read was attempted past the end of the file. </exception>
  47. </member>
  48. <member name="M:AsyncExtensions.ReadAsync(System.IO.Stream,System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  49. <summary>
  50. Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.
  51. </summary>
  52. <returns>A Task that represents the asynchronous read.</returns>
  53. <param name="source">The source.</param>
  54. <param name="buffer">The buffer to read data into. </param>
  55. <param name="offset">The byte offset in at which to begin reading. </param>
  56. <param name="count">The maximum number of bytes to read. </param>
  57. <param name="cancellationToken">The cancellation token.</param>
  58. <exception cref="T:System.ArgumentException">The array length minus is less than <paramref name="count" />. </exception>
  59. <exception cref="T:System.ArgumentNullException"> is null. </exception>
  60. <exception cref="T:System.ArgumentOutOfRangeException"> or <paramref name="count" /> is negative. </exception>
  61. <exception cref="T:System.IO.IOException">An asynchronous read was attempted past the end of the file. </exception>
  62. </member>
  63. <member name="M:AsyncExtensions.WriteAsync(System.IO.Stream,System.Byte[],System.Int32,System.Int32)">
  64. <summary>
  65. Writes asynchronously a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.
  66. </summary>
  67. <returns>A Task that represents the asynchronous write.</returns>
  68. <param name="source">The source.</param>
  69. <param name="buffer">The buffer containing data to write to the current stream.</param>
  70. <param name="offset">The zero-based byte offset in at which to begin copying bytes to the current stream.</param>
  71. <param name="count">The maximum number of bytes to write. </param>
  72. <exception cref="T:System.ArgumentException"> length minus <paramref name="offset" /> is less than <paramref name="count" />. </exception>
  73. <exception cref="T:System.ArgumentNullException"> is null. </exception>
  74. <exception cref="T:System.ArgumentOutOfRangeException"> or <paramref name="count" /> is negative. </exception>
  75. <exception cref="T:System.NotSupportedException">The stream does not support writing. </exception>
  76. <exception cref="T:System.ObjectDisposedException">The stream is closed. </exception>
  77. <exception cref="T:System.IO.IOException">An I/O error occurred. </exception>
  78. </member>
  79. <member name="M:AsyncExtensions.WriteAsync(System.IO.Stream,System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)">
  80. <summary>
  81. Writes asynchronously a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.
  82. </summary>
  83. <returns>A Task that represents the asynchronous write.</returns>
  84. <param name="source">The source.</param>
  85. <param name="buffer">The buffer containing data to write to the current stream.</param>
  86. <param name="offset">The zero-based byte offset in at which to begin copying bytes to the current stream.</param>
  87. <param name="count">The maximum number of bytes to write. </param>
  88. <param name="cancellationToken">The cancellation token.</param>
  89. <exception cref="T:System.ArgumentException"> length minus <paramref name="offset" /> is less than <paramref name="count" />. </exception>
  90. <exception cref="T:System.ArgumentNullException"> is null. </exception>
  91. <exception cref="T:System.ArgumentOutOfRangeException"> or <paramref name="count" /> is negative. </exception>
  92. <exception cref="T:System.NotSupportedException">The stream does not support writing. </exception>
  93. <exception cref="T:System.ObjectDisposedException">The stream is closed. </exception>
  94. <exception cref="T:System.IO.IOException">An I/O error occurred. </exception>
  95. </member>
  96. <member name="M:AsyncExtensions.FlushAsync(System.IO.Stream)">
  97. <summary>
  98. Flushes asynchronously the current stream.
  99. </summary>
  100. <returns>A Task that represents the asynchronous flush.</returns>
  101. </member>
  102. <member name="M:AsyncExtensions.FlushAsync(System.IO.Stream,System.Threading.CancellationToken)">
  103. <summary>
  104. Flushes asynchronously the current stream.
  105. </summary>
  106. <returns>A Task that represents the asynchronous flush.</returns>
  107. </member>
  108. <member name="M:AsyncExtensions.CopyToAsync(System.IO.Stream,System.IO.Stream)">
  109. <summary>
  110. Reads all the bytes from the current stream and writes them to the destination stream.
  111. </summary>
  112. <param name="source">The source stream.</param>
  113. <param name="destination">The stream that will contain the contents of the current stream.</param>
  114. <returns>A Task that represents the asynchronous operation.</returns>
  115. </member>
  116. <member name="M:AsyncExtensions.CopyToAsync(System.IO.Stream,System.IO.Stream,System.Int32)">
  117. <summary>
  118. Reads all the bytes from the current stream and writes them to the destination stream.
  119. </summary>
  120. <param name="source">The source stream.</param>
  121. <param name="destination">The stream that will contain the contents of the current stream.</param>
  122. <param name="bufferSize">The size of the buffer. This value must be greater than zero. The default size is 4096.</param>
  123. <returns>A Task that represents the asynchronous operation.</returns>
  124. </member>
  125. <member name="M:AsyncExtensions.CopyToAsync(System.IO.Stream,System.IO.Stream,System.Int32,System.Threading.CancellationToken)">
  126. <summary>
  127. Reads all the bytes from the current stream and writes them to the destination stream.
  128. </summary>
  129. <param name="source">The source stream.</param>
  130. <param name="destination">The stream that will contain the contents of the current stream.</param>
  131. <param name="bufferSize">The size of the buffer. This value must be greater than zero. The default size is 4096.</param>
  132. <param name="cancellationToken">The cancellation token to use to cancel the asynchronous operation.</param>
  133. <returns>A Task that represents the asynchronous operation.</returns>
  134. </member>
  135. <member name="M:AsyncExtensions.CopyToAsyncInternal(System.IO.Stream,System.IO.Stream,System.Int32,System.Threading.CancellationToken)">
  136. <summary>
  137. Reads all the bytes from the current stream and writes them to the destination stream.
  138. </summary>
  139. <param name="source">The source stream.</param>
  140. <param name="destination">The stream that will contain the contents of the current stream.</param>
  141. <param name="bufferSize">The size of the buffer. This value must be greater than zero. The default size is 4096.</param>
  142. <param name="cancellationToken">The cancellation token to use to cancel the asynchronous operation.</param>
  143. <returns>A Task that represents the asynchronous operation.</returns>
  144. </member>
  145. <member name="M:AsyncExtensions.ReadAsync(System.IO.TextReader,System.Char[],System.Int32,System.Int32)">
  146. <summary>
  147. Reads a maximum of count characters from the reader asynchronously and writes
  148. the data to buffer, beginning at index.
  149. </summary>
  150. <param name="buffer">
  151. When the operation completes, contains the specified character array with the
  152. values between index and (index + count - 1) replaced by the characters read
  153. from the current source.
  154. </param>
  155. <param name="count">
  156. The maximum number of characters to read. If the end of the stream is reached
  157. before count of characters is read into buffer, the current method returns.
  158. </param>
  159. <param name="index">The place in buffer at which to begin writing.</param>
  160. <param name="source">the source reader.</param>
  161. <returns>A Task that represents the asynchronous operation.</returns>
  162. </member>
  163. <member name="M:AsyncExtensions.ReadBlockAsync(System.IO.TextReader,System.Char[],System.Int32,System.Int32)">
  164. <summary>
  165. Reads asynchronously a maximum of count characters from the current stream, and writes the
  166. data to buffer, beginning at index.
  167. </summary>
  168. <param name="source">The source reader.</param>
  169. <param name="buffer">
  170. When this method returns, this parameter contains the specified character
  171. array with the values between index and (index + count -1) replaced by the
  172. characters read from the current source.
  173. </param>
  174. <param name="index">The position in buffer at which to begin writing.</param>
  175. <param name="count">The maximum number of characters to read.</param>
  176. <returns>A Task that represents the asynchronous operation.</returns>
  177. </member>
  178. <member name="M:AsyncExtensions.ReadLineAsync(System.IO.TextReader)">
  179. <summary>
  180. Reads a line of characters from the reader and returns the string asynchronously.
  181. </summary>
  182. <param name="source">the source reader.</param>
  183. <returns>A Task that represents the asynchronous operation.</returns>
  184. </member>
  185. <member name="M:AsyncExtensions.ReadToEndAsync(System.IO.TextReader)">
  186. <summary>
  187. Reads all characters from the current position to the end of the TextReader
  188. and returns them as one string asynchronously.
  189. </summary>
  190. <param name="source">the source reader.</param>
  191. <returns>A Task that represents the asynchronous operation.</returns>
  192. </member>
  193. <member name="M:AsyncExtensions.WriteAsync(System.IO.TextWriter,System.String)">
  194. <summary>Writes a string asynchronously to a text stream.</summary>
  195. <param name="target">The writer.</param>
  196. <param name="value">The string to write.</param>
  197. <returns>A Task representing the asynchronous write.</returns>
  198. </member>
  199. <member name="M:AsyncExtensions.WriteAsync(System.IO.TextWriter,System.Char)">
  200. <summary>Writes a char asynchronously to a text stream.</summary>
  201. <param name="target">The writer.</param>
  202. <param name="value">The char to write.</param>
  203. <returns>A Task representing the asynchronous write.</returns>
  204. </member>
  205. <member name="M:AsyncExtensions.WriteAsync(System.IO.TextWriter,System.Char[])">
  206. <summary>Writes a char array asynchronously to a text stream.</summary>
  207. <param name="target">The writer.</param>
  208. <param name="buffer">The buffer to write.</param>
  209. <returns>A Task representing the asynchronous write.</returns>
  210. </member>
  211. <member name="M:AsyncExtensions.WriteAsync(System.IO.TextWriter,System.Char[],System.Int32,System.Int32)">
  212. <summary>Writes a subarray of characters asynchronously to a text stream.</summary>
  213. <param name="target">The writer.</param>
  214. <param name="buffer">The buffer to write.</param>
  215. <param name="index">Starting index in the buffer.</param>
  216. <param name="count">The number of characters to write.</param>
  217. <returns>A Task representing the asynchronous write.</returns>
  218. </member>
  219. <member name="M:AsyncExtensions.WriteLineAsync(System.IO.TextWriter)">
  220. <summary>Writes a line terminator asynchronously to a text stream.</summary>
  221. <param name="target">The writer.</param>
  222. <returns>A Task representing the asynchronous write.</returns>
  223. </member>
  224. <member name="M:AsyncExtensions.WriteLineAsync(System.IO.TextWriter,System.String)">
  225. <summary>Writes a string followed by a line terminator asynchronously to a text stream.</summary>
  226. <param name="target">The writer.</param>
  227. <param name="value">The string to write.</param>
  228. <returns>A Task representing the asynchronous write.</returns>
  229. </member>
  230. <member name="M:AsyncExtensions.WriteLineAsync(System.IO.TextWriter,System.Char)">
  231. <summary>Writes a char followed by a line terminator asynchronously to a text stream.</summary>
  232. <param name="target">The writer.</param>
  233. <param name="value">The char to write.</param>
  234. <returns>A Task representing the asynchronous write.</returns>
  235. </member>
  236. <member name="M:AsyncExtensions.WriteLineAsync(System.IO.TextWriter,System.Char[])">
  237. <summary>Writes a char array followed by a line terminator asynchronously to a text stream.</summary>
  238. <param name="target">The writer.</param>
  239. <param name="buffer">The buffer to write.</param>
  240. <returns>A Task representing the asynchronous write.</returns>
  241. </member>
  242. <member name="M:AsyncExtensions.WriteLineAsync(System.IO.TextWriter,System.Char[],System.Int32,System.Int32)">
  243. <summary>Writes a subarray of characters followed by a line terminator asynchronously to a text stream.</summary>
  244. <param name="target">The writer.</param>
  245. <param name="buffer">The buffer to write.</param>
  246. <param name="index">Starting index in the buffer.</param>
  247. <param name="count">The number of characters to write.</param>
  248. <returns>A Task representing the asynchronous write.</returns>
  249. </member>
  250. <member name="M:AsyncExtensions.FlushAsync(System.IO.TextWriter)">
  251. <summary>
  252. Clears all buffers for the current writer and causes any buffered data to
  253. be written to the underlying device.
  254. </summary>
  255. <param name="target">The writer.</param>
  256. <returns>A Task representing the asynchronous flush.</returns>
  257. </member>
  258. <member name="M:AsyncExtensions.GetResponseAsync(System.Net.WebRequest)">
  259. <summary>Starts an asynchronous request for a web resource.</summary>
  260. <returns>Task that represents the asynchronous request.</returns>
  261. <exception cref="T:System.InvalidOperationException">The stream is already in use by a previous call to . </exception>
  262. <PermissionSet> <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" /> </PermissionSet>
  263. <param name="source">The source.</param>
  264. </member>
  265. <member name="M:AsyncExtensions.GetRequestStreamAsync(System.Net.WebRequest)">
  266. <summary>Starts an asynchronous request for a object to use to write data.</summary>
  267. <returns>Task that represents the asynchronous request.</returns>
  268. <exception cref="T:System.Net.ProtocolViolationException">The property is GET and the application writes to the stream. </exception>
  269. <exception cref="T:System.InvalidOperationException">The stream is being used by a previous call to . </exception>
  270. <exception cref="T:System.ApplicationException">No write stream is available. </exception>
  271. <PermissionSet> <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" /> </PermissionSet>
  272. <param name="source">The source.</param>
  273. </member>
  274. </members>
  275. </doc>