System.Threading.Channels.xml 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225
  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.CreateUnbounded``1">
  51. <summary>Creates an unbounded channel usable by any number of readers and writers concurrently.</summary>
  52. <typeparam name="T">The type of data in the channel.</typeparam>
  53. <returns>The created channel.</returns>
  54. </member>
  55. <member name="M:System.Threading.Channels.Channel.CreateUnbounded``1(System.Threading.Channels.UnboundedChannelOptions)">
  56. <summary>Creates an unbounded channel subject to the provided options.</summary>
  57. <param name="options">Options that guide the behavior of the channel.</param>
  58. <typeparam name="T">Specifies the type of data in the channel.</typeparam>
  59. <returns>The created channel.</returns>
  60. </member>
  61. <member name="T:System.Threading.Channels.Channel`1">
  62. <summary>Provides a base class for channels that support reading and writing elements of type <typeparamref name="T" />.</summary>
  63. <typeparam name="T">Specifies the type of data readable and writable in the channel.</typeparam>
  64. </member>
  65. <member name="M:System.Threading.Channels.Channel`1.#ctor">
  66. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.Channel`1" /> class.</summary>
  67. </member>
  68. <member name="T:System.Threading.Channels.Channel`2">
  69. <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>
  70. <typeparam name="TWrite">Specifies the type of data that may be written to the channel.</typeparam>
  71. <typeparam name="TRead">Specifies the type of data that may be read from the channel.</typeparam>
  72. </member>
  73. <member name="M:System.Threading.Channels.Channel`2.#ctor">
  74. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.Channel`2" /> class.</summary>
  75. </member>
  76. <member name="M:System.Threading.Channels.Channel`2.op_Implicit(System.Threading.Channels.Channel{`0,`1})~System.Threading.Channels.ChannelReader{`1}">
  77. <summary>Implicit cast from a <see cref="T:System.Threading.Channels.Channel`2" /> to its readable half.</summary>
  78. <param name="channel">The <see cref="T:System.Threading.Channels.Channel`2" /> being cast.</param>
  79. <returns>The readable half.</returns>
  80. </member>
  81. <member name="M:System.Threading.Channels.Channel`2.op_Implicit(System.Threading.Channels.Channel{`0,`1})~System.Threading.Channels.ChannelWriter{`0}">
  82. <summary>Implicit cast from a <see cref="T:System.Threading.Channels.Channel`2" /> to its writable half.</summary>
  83. <param name="channel">The <see cref="T:System.Threading.Channels.Channel`2" /> being cast.</param>
  84. <returns>The writable half.</returns>
  85. </member>
  86. <member name="P:System.Threading.Channels.Channel`2.Reader">
  87. <summary>Gets the readable half of this channel.</summary>
  88. </member>
  89. <member name="P:System.Threading.Channels.Channel`2.Writer">
  90. <summary>Gets the writable half of this channel.</summary>
  91. </member>
  92. <member name="T:System.Threading.Channels.ChannelClosedException">
  93. <summary>Exception thrown when a channel is used after it's been closed.</summary>
  94. </member>
  95. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor">
  96. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  97. </member>
  98. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.Exception)">
  99. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  100. <param name="innerException">The exception that is the cause of this exception.</param>
  101. </member>
  102. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
  103. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class with serialized data.</summary>
  104. <param name="info">The object that holds the serialized object data.</param>
  105. <param name="context">The contextual information about the source or destination.</param>
  106. </member>
  107. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.String)">
  108. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  109. <param name="message">The message that describes the error.</param>
  110. </member>
  111. <member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.String,System.Exception)">
  112. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
  113. <param name="message">The message that describes the error.</param>
  114. <param name="innerException">The exception that is the cause of this exception.</param>
  115. </member>
  116. <member name="T:System.Threading.Channels.ChannelOptions">
  117. <summary>Provides options that control the behavior of channel instances.</summary>
  118. </member>
  119. <member name="M:System.Threading.Channels.ChannelOptions.#ctor">
  120. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelOptions" /> class.</summary>
  121. </member>
  122. <member name="P:System.Threading.Channels.ChannelOptions.AllowSynchronousContinuations">
  123. <summary>
  124. <see langword="true" /> if operations performed on a channel may synchronously invoke continuations subscribed to
  125. notifications of pending async operations; <see langword="false" /> if all continuations should be invoked asynchronously.</summary>
  126. </member>
  127. <member name="P:System.Threading.Channels.ChannelOptions.SingleReader">
  128. <summary>
  129. <see langword="true" /> readers from the channel guarantee that there will only ever be at most one read operation at a time;
  130. <see langword="false" /> if no such constraint is guaranteed.</summary>
  131. </member>
  132. <member name="P:System.Threading.Channels.ChannelOptions.SingleWriter">
  133. <summary>
  134. <see langword="true" /> if writers to the channel guarantee that there will only ever be at most one write operation
  135. at a time; <see langword="false" /> if no such constraint is guaranteed.</summary>
  136. </member>
  137. <member name="T:System.Threading.Channels.ChannelReader`1">
  138. <summary>Provides a base class for reading from a channel.</summary>
  139. <typeparam name="T">Specifies the type of data that may be read from the channel.</typeparam>
  140. </member>
  141. <member name="M:System.Threading.Channels.ChannelReader`1.#ctor">
  142. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelReader`1" /> class.</summary>
  143. </member>
  144. <member name="M:System.Threading.Channels.ChannelReader`1.ReadAllAsync(System.Threading.CancellationToken)">
  145. <summary>Creates an <see cref="T:System.Collections.Generic.IAsyncEnumerable`1" /> that enables reading all of the data from the channel.</summary>
  146. <param name="cancellationToken">The cancellation token to use to cancel the enumeration.</param>
  147. <returns>The created async enumerable.</returns>
  148. </member>
  149. <member name="M:System.Threading.Channels.ChannelReader`1.ReadAsync(System.Threading.CancellationToken)">
  150. <summary>Asynchronously reads an item from the channel.</summary>
  151. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the read operation.</param>
  152. <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that represents the asynchronous read operation.</returns>
  153. </member>
  154. <member name="M:System.Threading.Channels.ChannelReader`1.TryRead(`0@)">
  155. <summary>Attempts to read an item from the channel.</summary>
  156. <param name="item">The read item, or a default value if no item could be read.</param>
  157. <returns>
  158. <see langword="true" /> if an item was read; otherwise, <see langword="false" />.</returns>
  159. </member>
  160. <member name="M:System.Threading.Channels.ChannelReader`1.WaitToReadAsync(System.Threading.CancellationToken)">
  161. <summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when data is available to read.</summary>
  162. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
  163. <returns>
  164. <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
  165. 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>
  166. <para>If the channel completes with an exception, the task will also complete with an exception.</para>
  167. </returns>
  168. </member>
  169. <member name="P:System.Threading.Channels.ChannelReader`1.CanCount">
  170. <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>
  171. </member>
  172. <member name="P:System.Threading.Channels.ChannelReader`1.Completion">
  173. <summary>Gets a <see cref="T:System.Threading.Tasks.Task" /> that completes when no more data will ever
  174. be available to be read from this channel.</summary>
  175. </member>
  176. <member name="P:System.Threading.Channels.ChannelReader`1.Count">
  177. <summary>Gets the current number of items available from this channel reader.</summary>
  178. <exception cref="T:System.NotSupportedException">Counting is not supported on this instance.</exception>
  179. </member>
  180. <member name="T:System.Threading.Channels.ChannelWriter`1">
  181. <summary>Provides a base class for writing to a channel.</summary>
  182. <typeparam name="T">Specifies the type of data that may be written to the channel.</typeparam>
  183. </member>
  184. <member name="M:System.Threading.Channels.ChannelWriter`1.#ctor">
  185. <summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelWriter`1" /> class.</summary>
  186. </member>
  187. <member name="M:System.Threading.Channels.ChannelWriter`1.Complete(System.Exception)">
  188. <summary>Mark the channel as being complete, meaning no more items will be written to it.</summary>
  189. <param name="error">Optional Exception indicating a failure that's causing the channel to complete.</param>
  190. <exception cref="T:System.InvalidOperationException">The channel has already been marked as complete.</exception>
  191. </member>
  192. <member name="M:System.Threading.Channels.ChannelWriter`1.TryComplete(System.Exception)">
  193. <summary>Attempts to mark the channel as being completed, meaning no more data will be written to it.</summary>
  194. <param name="error">An <see cref="T:System.Exception" /> indicating the failure causing no more data to be written, or null for success.</param>
  195. <returns>
  196. <see langword="true" /> if this operation successfully completes the channel; otherwise, <see langword="false" /> if the channel could not be marked for completion,
  197. for example due to having already been marked as such, or due to not supporting completion.
  198. .</returns>
  199. </member>
  200. <member name="M:System.Threading.Channels.ChannelWriter`1.TryWrite(`0)">
  201. <summary>Attempts to write the specified item to the channel.</summary>
  202. <param name="item">The item to write.</param>
  203. <returns>
  204. <see langword="true" /> if the item was written; otherwise, <see langword="false" />.</returns>
  205. </member>
  206. <member name="M:System.Threading.Channels.ChannelWriter`1.WaitToWriteAsync(System.Threading.CancellationToken)">
  207. <summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when space is available to write an item.</summary>
  208. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
  209. <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
  210. or with a <see langword="false" /> result when no further writing will be permitted.</returns>
  211. </member>
  212. <member name="M:System.Threading.Channels.ChannelWriter`1.WriteAsync(`0,System.Threading.CancellationToken)">
  213. <summary>Asynchronously writes an item to the channel.</summary>
  214. <param name="item">The value to write to the channel.</param>
  215. <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the write operation.</param>
  216. <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> that represents the asynchronous write operation.</returns>
  217. </member>
  218. <member name="T:System.Threading.Channels.UnboundedChannelOptions">
  219. <summary>Provides options that control the behavior of unbounded <see cref="T:System.Threading.Channels.Channel`1" /> instances.</summary>
  220. </member>
  221. <member name="M:System.Threading.Channels.UnboundedChannelOptions.#ctor">
  222. <summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.UnboundedChannelOptions" /> class.</summary>
  223. </member>
  224. </members>
  225. </doc>