System.Threading.Channels.xml 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Threading.Channels</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Threading.Channels.BoundedChannelFullMode">
  8. <summary>Specifies the behavior to use when writing to a bounded channel that is already full.</summary>
  9. </member>
  10. <member name="F:System.Threading.Channels.BoundedChannelFullMode.DropNewest">
  11. <summary>Removes and ignores the newest item in the channel in order to make room for the item being written.</summary>
  12. </member>
  13. <member name="F:System.Threading.Channels.BoundedChannelFullMode.DropOldest">
  14. <summary>Removes and ignores the oldest item in the channel in order to make room for the item being written.</summary>
  15. </member>
  16. <member name="F:System.Threading.Channels.BoundedChannelFullMode.DropWrite">
  17. <summary>Drops the item being written.</summary>
  18. </member>
  19. <member name="F:System.Threading.Channels.BoundedChannelFullMode.Wait">
  20. <summary>Waits for space to be available in order to complete the write operation.</summary>
  21. </member>
  22. <member name="T:System.Threading.Channels.BoundedChannelOptions">
  23. <summary>Provides options that control the behavior of bounded <see cref="T:System.Threading.Channels.Channel`1" /> instances.</summary>
  24. </member>
  25. <member name="M:System.Threading.Channels.BoundedChannelOptions.#ctor(System.Int32)">
  26. <summary>Initializes the options.</summary>
  27. <param name="capacity">The maximum number of items the bounded channel may store.</param>
  28. </member>
  29. <member name="P:System.Threading.Channels.BoundedChannelOptions.Capacity">
  30. <summary>Gets or sets the maximum number of items the bounded channel may store.</summary>
  31. </member>
  32. <member name="P:System.Threading.Channels.BoundedChannelOptions.FullMode">
  33. <summary>Gets or sets the behavior incurred by write operations when the channel is full.</summary>
  34. </member>
  35. <member name="T:System.Threading.Channels.Channel">
  36. <summary>Provides static methods for creating channels.</summary>
  37. </member>
  38. <member name="M:System.Threading.Channels.Channel.CreateBounded``1(System.Int32)">
  39. <summary>Creates a channel with the specified maximum capacity.</summary>
  40. <param name="capacity">The maximum number of items the channel may store.</param>
  41. <typeparam name="T">Specifies the type of data in the channel.</typeparam>
  42. <returns>The created channel.</returns>
  43. </member>
  44. <member name="M:System.Threading.Channels.Channel.CreateBounded``1(System.Threading.Channels.BoundedChannelOptions)">
  45. <summary>Creates a channel with the specified maximum capacity.</summary>
  46. <param name="options">Options that guide the behavior of the channel.</param>
  47. <typeparam name="T">Specifies the type of data in the channel.</typeparam>
  48. <returns>The created channel.</returns>
  49. </member>
  50. <member name="M:System.Threading.Channels.Channel.CreateBounded``1(System.Threading.Channels.BoundedChannelOptions,System.Action{``0})">
  51. <summary>Creates a channel subject to the provided options.</summary>
  52. <param name="options">Options that guide the behavior of the channel.</param>
  53. <param name="itemDropped">Delegate that will be called when item is being dropped from channel. See <see cref="T:System.Threading.Channels.BoundedChannelFullMode" />.</param>
  54. <typeparam name="T">Specifies the type of data in the channel.</typeparam>
  55. <returns>The created channel.</returns>
  56. </member>
  57. <member name="M:System.Threading.Channels.Channel.CreateUnbounded``1">
  58. <summary>Creates an unbounded channel usable by any number of readers and writers concurrently.</summary>
  59. <typeparam name="T">The type of data in the channel.</typeparam>
  60. <returns>The created channel.</returns>
  61. </member>
  62. <member name="M:System.Threading.Channels.Channel.CreateUnbounded``1(System.Threading.Channels.UnboundedChannelOptions)">
  63. <summary>Creates an unbounded channel subject to the provided options.</summary>
  64. <param name="options">Options that guide the behavior of the channel.</param>
  65. <typeparam name="T">Specifies the type of data in the channel.</typeparam>
  66. <returns>The created channel.</returns>
  67. </member>
  68. <member name="T:System.Threading.Channels.Channel`1">
  69. <summary>Provides a base class for channels that support reading and writing elements of type <typeparamref name="T" />.</summary>
  70. <typeparam name="T">Specifies the type of data readable and writable in the channel.</typeparam>
  71. </member>
  72. <member name="M:System.Threading.Channels.Channel`1.#ctor">
  73. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.Channel`1" /> class.</summary>
  74. </member>
  75. <member name="T:System.Threading.Channels.Channel`2">
  76. <summary>Provides a base class for channels that support reading elements of type <typeparamref name="TRead" /> and writing elements of type <typeparamref name="TWrite" />.</summary>
  77. <typeparam name="TWrite">Specifies the type of data that may be written to the channel.</typeparam>
  78. <typeparam name="TRead">Specifies the type of data that may be read from the channel.</typeparam>
  79. </member>
  80. <member name="M:System.Threading.Channels.Channel`2.#ctor">
  81. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.Channel`2" /> class.</summary>
  82. </member>
  83. <member name="M:System.Threading.Channels.Channel`2.op_Implicit(System.Threading.Channels.Channel{`0,`1})~System.Threading.Channels.ChannelReader{`1}">
  84. <summary>Implicit cast from a <see cref="T:System.Threading.Channels.Channel`2" /> to its readable half.</summary>
  85. <param name="channel">The <see cref="T:System.Threading.Channels.Channel`2" /> being cast.</param>
  86. <returns>The readable half.</returns>
  87. </member>
  88. <member name="M:System.Threading.Channels.Channel`2.op_Implicit(System.Threading.Channels.Channel{`0,`1})~System.Threading.Channels.ChannelWriter{`0}">
  89. <summary>Implicit cast from a <see cref="T:System.Threading.Channels.Channel`2" /> to its writable half.</summary>
  90. <param name="channel">The <see cref="T:System.Threading.Channels.Channel`2" /> being cast.</param>
  91. <returns>The writable half.</returns>
  92. </member>
  93. <member name="P:System.Threading.Channels.Channel`2.Reader">
  94. <summary>Gets the readable half of this channel.</summary>
  95. </member>
  96. <member name="P:System.Threading.Channels.Channel`2.Writer">
  97. <summary>Gets the writable half of this channel.</summary>
  98. </member>
  99. <member name="T:System.Threading.Channels.ChannelClosedException">
  100. <summary>Exception thrown when a channel is used after it's been closed.</summary>
  101. </member>
  102. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor">
  103. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  104. </member>
  105. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.Exception)">
  106. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  107. <param name="innerException">The exception that is the cause of this exception.</param>
  108. </member>
  109. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
  110. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class with serialized data.</summary>
  111. <param name="info">The object that holds the serialized object data.</param>
  112. <param name="context">The contextual information about the source or destination.</param>
  113. </member>
  114. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.String)">
  115. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  116. <param name="message">The message that describes the error.</param>
  117. </member>
  118. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.String,System.Exception)">
  119. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  120. <param name="message">The message that describes the error.</param>
  121. <param name="innerException">The exception that is the cause of this exception.</param>
  122. </member>
  123. <member name="T:System.Threading.Channels.ChannelOptions">
  124. <summary>Provides options that control the behavior of channel instances.</summary>
  125. </member>
  126. <member name="M:System.Threading.Channels.ChannelOptions.#ctor">
  127. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelOptions" /> class.</summary>
  128. </member>
  129. <member name="P:System.Threading.Channels.ChannelOptions.AllowSynchronousContinuations">
  130. <summary>
  131. <see langword="true" /> if operations performed on a channel may synchronously invoke continuations subscribed to
  132. notifications of pending async operations; <see langword="false" /> if all continuations should be invoked asynchronously.</summary>
  133. </member>
  134. <member name="P:System.Threading.Channels.ChannelOptions.SingleReader">
  135. <summary>
  136. <see langword="true" /> readers from the channel guarantee that there will only ever be at most one read operation at a time;
  137. <see langword="false" /> if no such constraint is guaranteed.</summary>
  138. </member>
  139. <member name="P:System.Threading.Channels.ChannelOptions.SingleWriter">
  140. <summary>
  141. <see langword="true" /> if writers to the channel guarantee that there will only ever be at most one write operation
  142. at a time; <see langword="false" /> if no such constraint is guaranteed.</summary>
  143. </member>
  144. <member name="T:System.Threading.Channels.ChannelReader`1">
  145. <summary>Provides a base class for reading from a channel.</summary>
  146. <typeparam name="T">Specifies the type of data that may be read from the channel.</typeparam>
  147. </member>
  148. <member name="M:System.Threading.Channels.ChannelReader`1.#ctor">
  149. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelReader`1" /> class.</summary>
  150. </member>
  151. <member name="M:System.Threading.Channels.ChannelReader`1.ReadAllAsync(System.Threading.CancellationToken)">
  152. <summary>Creates an <see cref="T:System.Collections.Generic.IAsyncEnumerable`1" /> that enables reading all of the data from the channel.</summary>
  153. <param name="cancellationToken">The cancellation token to use to cancel the enumeration. If data is immediately ready for reading, then that data may be yielded even after cancellation has been requested.</param>
  154. <returns>The created async enumerable.</returns>
  155. </member>
  156. <member name="M:System.Threading.Channels.ChannelReader`1.ReadAsync(System.Threading.CancellationToken)">
  157. <summary>Asynchronously reads an item from the channel.</summary>
  158. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the read operation.</param>
  159. <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that represents the asynchronous read operation.</returns>
  160. </member>
  161. <member name="M:System.Threading.Channels.ChannelReader`1.TryPeek(`0@)">
  162. <summary>Attempts to peek at an item from the channel.</summary>
  163. <param name="item">The peeked item, or a default value if no item could be peeked.</param>
  164. <returns>
  165. <see langword="true" /> if an item was read; otherwise, <see langword="false" />.</returns>
  166. </member>
  167. <member name="M:System.Threading.Channels.ChannelReader`1.TryRead(`0@)">
  168. <summary>Attempts to read an item from the channel.</summary>
  169. <param name="item">The read item, or a default value if no item could be read.</param>
  170. <returns>
  171. <see langword="true" /> if an item was read; otherwise, <see langword="false" />.</returns>
  172. </member>
  173. <member name="M:System.Threading.Channels.ChannelReader`1.WaitToReadAsync(System.Threading.CancellationToken)">
  174. <summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when data is available to read.</summary>
  175. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
  176. <returns>
  177. <para>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when data is available to read
  178. or with a <see langword="false" /> result when no further data will ever be available to be read due to the channel completing successfully.</para>
  179. <para>If the channel completes with an exception, the task will also complete with an exception.</para>
  180. </returns>
  181. </member>
  182. <member name="P:System.Threading.Channels.ChannelReader`1.CanCount">
  183. <summary>Gets a value that indicates whether <see cref="P:System.Threading.Channels.ChannelReader`1.Count" /> is available for use on this <see cref="T:System.Threading.Channels.ChannelReader`1" /> instance.</summary>
  184. </member>
  185. <member name="P:System.Threading.Channels.ChannelReader`1.CanPeek">
  186. <summary>Gets a value that indicates whether <see cref="M:System.Threading.Channels.ChannelReader`1.TryPeek(`0@)" /> is available for use on this <see cref="T:System.Threading.Channels.ChannelReader`1" /> instance.</summary>
  187. <returns>
  188. <see langword="true" /> if peeking is supported by this channel instance; <see langword="false" /> otherwise.</returns>
  189. </member>
  190. <member name="P:System.Threading.Channels.ChannelReader`1.Completion">
  191. <summary>Gets a <see cref="T:System.Threading.Tasks.Task" /> that completes when no more data will ever
  192. be available to be read from this channel.</summary>
  193. </member>
  194. <member name="P:System.Threading.Channels.ChannelReader`1.Count">
  195. <summary>Gets the current number of items available from this channel reader.</summary>
  196. <exception cref="T:System.NotSupportedException">Counting is not supported on this instance.</exception>
  197. </member>
  198. <member name="T:System.Threading.Channels.ChannelWriter`1">
  199. <summary>Provides a base class for writing to a channel.</summary>
  200. <typeparam name="T">Specifies the type of data that may be written to the channel.</typeparam>
  201. </member>
  202. <member name="M:System.Threading.Channels.ChannelWriter`1.#ctor">
  203. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelWriter`1" /> class.</summary>
  204. </member>
  205. <member name="M:System.Threading.Channels.ChannelWriter`1.Complete(System.Exception)">
  206. <summary>Mark the channel as being complete, meaning no more items will be written to it.</summary>
  207. <param name="error">Optional Exception indicating a failure that's causing the channel to complete.</param>
  208. <exception cref="T:System.InvalidOperationException">The channel has already been marked as complete.</exception>
  209. </member>
  210. <member name="M:System.Threading.Channels.ChannelWriter`1.TryComplete(System.Exception)">
  211. <summary>Attempts to mark the channel as being completed, meaning no more data will be written to it.</summary>
  212. <param name="error">An <see cref="T:System.Exception" /> indicating the failure causing no more data to be written, or null for success.</param>
  213. <returns>
  214. <see langword="true" /> if this operation successfully completes the channel; otherwise, <see langword="false" /> if the channel could not be marked for completion,
  215. for example due to having already been marked as such, or due to not supporting completion.
  216. .</returns>
  217. </member>
  218. <member name="M:System.Threading.Channels.ChannelWriter`1.TryWrite(`0)">
  219. <summary>Attempts to write the specified item to the channel.</summary>
  220. <param name="item">The item to write.</param>
  221. <returns>
  222. <see langword="true" /> if the item was written; otherwise, <see langword="false" />.</returns>
  223. </member>
  224. <member name="M:System.Threading.Channels.ChannelWriter`1.WaitToWriteAsync(System.Threading.CancellationToken)">
  225. <summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when space is available to write an item.</summary>
  226. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
  227. <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when space is available to write an item
  228. or with a <see langword="false" /> result when no further writing will be permitted.</returns>
  229. </member>
  230. <member name="M:System.Threading.Channels.ChannelWriter`1.WriteAsync(`0,System.Threading.CancellationToken)">
  231. <summary>Asynchronously writes an item to the channel.</summary>
  232. <param name="item">The value to write to the channel.</param>
  233. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the write operation.</param>
  234. <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> that represents the asynchronous write operation.</returns>
  235. </member>
  236. <member name="T:System.Threading.Channels.UnboundedChannelOptions">
  237. <summary>Provides options that control the behavior of unbounded <see cref="T:System.Threading.Channels.Channel`1" /> instances.</summary>
  238. </member>
  239. <member name="M:System.Threading.Channels.UnboundedChannelOptions.#ctor">
  240. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.UnboundedChannelOptions" /> class.</summary>
  241. </member>
  242. </members>
  243. </doc>