dc/packages/System.Threading.Channels.4.7.1/lib/netstandard2.0/System.Threading.Channels.xml

217 lines
15 KiB
XML
Raw Normal View History

2022-04-01 17:03:54 +08:00
<?xml version="1.0" encoding="utf-8"?>
<doc>
<assembly>
<name>System.Threading.Channels</name>
</assembly>
<members>
<member name="T:System.Threading.Channels.BoundedChannelFullMode">
<summary>Specifies the behavior to use when writing to a bounded channel that is already full.</summary>
</member>
<member name="F:System.Threading.Channels.BoundedChannelFullMode.DropNewest">
<summary>Removes and ignores the newest item in the channel in order to make room for the item being written.</summary>
</member>
<member name="F:System.Threading.Channels.BoundedChannelFullMode.DropOldest">
<summary>Removes and ignores the oldest item in the channel in order to make room for the item being written.</summary>
</member>
<member name="F:System.Threading.Channels.BoundedChannelFullMode.DropWrite">
<summary>Drops the item being written.</summary>
</member>
<member name="F:System.Threading.Channels.BoundedChannelFullMode.Wait">
<summary>Waits for space to be available in order to complete the write operation.</summary>
</member>
<member name="T:System.Threading.Channels.BoundedChannelOptions">
<summary>Provides options that control the behavior of bounded <see cref="T:System.Threading.Channels.Channel`1" /> instances.</summary>
</member>
<member name="M:System.Threading.Channels.BoundedChannelOptions.#ctor(System.Int32)">
<summary>Initializes the options.</summary>
<param name="capacity">The maximum number of items the bounded channel may store.</param>
</member>
<member name="P:System.Threading.Channels.BoundedChannelOptions.Capacity">
<summary>Gets or sets the maximum number of items the bounded channel may store.</summary>
</member>
<member name="P:System.Threading.Channels.BoundedChannelOptions.FullMode">
<summary>Gets or sets the behavior incurred by write operations when the channel is full.</summary>
</member>
<member name="T:System.Threading.Channels.Channel">
<summary>Provides static methods for creating channels.</summary>
</member>
<member name="M:System.Threading.Channels.Channel.CreateBounded``1(System.Int32)">
<summary>Creates a channel with the specified maximum capacity.</summary>
<param name="capacity">The maximum number of items the channel may store.</param>
<typeparam name="T">Specifies the type of data in the channel.</typeparam>
<returns>The created channel.</returns>
</member>
<member name="M:System.Threading.Channels.Channel.CreateBounded``1(System.Threading.Channels.BoundedChannelOptions)">
<summary>Creates a channel with the specified maximum capacity.</summary>
<param name="options">Options that guide the behavior of the channel.</param>
<typeparam name="T">Specifies the type of data in the channel.</typeparam>
<returns>The created channel.</returns>
</member>
<member name="M:System.Threading.Channels.Channel.CreateUnbounded``1">
<summary>Creates an unbounded channel usable by any number of readers and writers concurrently.</summary>
<typeparam name="T">The type of data in the channel.</typeparam>
<returns>The created channel.</returns>
</member>
<member name="M:System.Threading.Channels.Channel.CreateUnbounded``1(System.Threading.Channels.UnboundedChannelOptions)">
<summary>Creates an unbounded channel subject to the provided options.</summary>
<param name="options">Options that guide the behavior of the channel.</param>
<typeparam name="T">Specifies the type of data in the channel.</typeparam>
<returns>The created channel.</returns>
</member>
<member name="T:System.Threading.Channels.Channel`1">
<summary>Provides a base class for channels that support reading and writing elements of type <typeparamref name="T" />.</summary>
<typeparam name="T">Specifies the type of data readable and writable in the channel.</typeparam>
</member>
<member name="M:System.Threading.Channels.Channel`1.#ctor">
<summary>Initializes an instance of the <see cref="T:System.Threading.Channels.Channel`1" /> class.</summary>
</member>
<member name="T:System.Threading.Channels.Channel`2">
<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>
<typeparam name="TWrite">Specifies the type of data that may be written to the channel.</typeparam>
<typeparam name="TRead">Specifies the type of data that may be read from the channel.</typeparam>
</member>
<member name="M:System.Threading.Channels.Channel`2.#ctor">
<summary>Initializes an instance of the <see cref="T:System.Threading.Channels.Channel`2" /> class.</summary>
</member>
<member name="M:System.Threading.Channels.Channel`2.op_Implicit(System.Threading.Channels.Channel{`0,`1})~System.Threading.Channels.ChannelReader{`1}">
<summary>Implicit cast from a <see cref="T:System.Threading.Channels.Channel`2" /> to its readable half.</summary>
<param name="channel">The <see cref="T:System.Threading.Channels.Channel`2" /> being cast.</param>
<returns>The readable half.</returns>
</member>
<member name="M:System.Threading.Channels.Channel`2.op_Implicit(System.Threading.Channels.Channel{`0,`1})~System.Threading.Channels.ChannelWriter{`0}">
<summary>Implicit cast from a <see cref="T:System.Threading.Channels.Channel`2" /> to its writable half.</summary>
<param name="channel">The <see cref="T:System.Threading.Channels.Channel`2" /> being cast.</param>
<returns>The writable half.</returns>
</member>
<member name="P:System.Threading.Channels.Channel`2.Reader">
<summary>Gets the readable half of this channel.</summary>
</member>
<member name="P:System.Threading.Channels.Channel`2.Writer">
<summary>Gets the writable half of this channel.</summary>
</member>
<member name="T:System.Threading.Channels.ChannelClosedException">
<summary>Exception thrown when a channel is used after it's been closed.</summary>
</member>
<member name="M:System.Threading.Channels.ChannelClosedException.#ctor">
<summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
</member>
<member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.Exception)">
<summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
<param name="innerException">The exception that is the cause of this exception.</param>
</member>
<member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
<summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class with serialized data.</summary>
<param name="info">The object that holds the serialized object data.</param>
<param name="context">The contextual information about the source or destination.</param>
</member>
<member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.String)">
<summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
<param name="message">The message that describes the error.</param>
</member>
<member name="M:System.Threading.Channels.ChannelClosedException.#ctor(System.String,System.Exception)">
<summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.ChannelClosedException" /> class.</summary>
<param name="message">The message that describes the error.</param>
<param name="innerException">The exception that is the cause of this exception.</param>
</member>
<member name="T:System.Threading.Channels.ChannelOptions">
<summary>Provides options that control the behavior of channel instances.</summary>
</member>
<member name="M:System.Threading.Channels.ChannelOptions.#ctor">
<summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelOptions" /> class.</summary>
</member>
<member name="P:System.Threading.Channels.ChannelOptions.AllowSynchronousContinuations">
<summary>
<see langword="true" /> if operations performed on a channel may synchronously invoke continuations subscribed to
notifications of pending async operations; <see langword="false" /> if all continuations should be invoked asynchronously.</summary>
</member>
<member name="P:System.Threading.Channels.ChannelOptions.SingleReader">
<summary>
<see langword="true" /> readers from the channel guarantee that there will only ever be at most one read operation at a time;
<see langword="false" /> if no such constraint is guaranteed.</summary>
</member>
<member name="P:System.Threading.Channels.ChannelOptions.SingleWriter">
<summary>
<see langword="true" /> if writers to the channel guarantee that there will only ever be at most one write operation
at a time; <see langword="false" /> if no such constraint is guaranteed.</summary>
</member>
<member name="T:System.Threading.Channels.ChannelReader`1">
<summary>Provides a base class for reading from a channel.</summary>
<typeparam name="T">Specifies the type of data that may be read from the channel.</typeparam>
</member>
<member name="M:System.Threading.Channels.ChannelReader`1.#ctor">
<summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelReader`1" /> class.</summary>
</member>
<member name="P:System.Threading.Channels.ChannelReader`1.Completion">
<summary>Gets a <see cref="T:System.Threading.Tasks.Task" /> that completes when no more data will ever
be available to be read from this channel.</summary>
</member>
<member name="M:System.Threading.Channels.ChannelReader`1.ReadAllAsync(System.Threading.CancellationToken)">
<summary>Creates an <see cref="T:System.Collections.Generic.IAsyncEnumerable`1" /> that enables reading all of the data from the channel.</summary>
<param name="cancellationToken">The cancellation token to use to cancel the enumeration.</param>
<returns>The created async enumerable.</returns>
</member>
<member name="M:System.Threading.Channels.ChannelReader`1.ReadAsync(System.Threading.CancellationToken)">
<summary>Asynchronously reads an item from the channel.</summary>
<param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the read operation.</param>
<returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that represents the asynchronous read operation.</returns>
</member>
<member name="M:System.Threading.Channels.ChannelReader`1.TryRead(`0@)">
<summary>Attempts to read an item from the channel.</summary>
<param name="item">The read item, or a default value if no item could be read.</param>
<returns>
<see langword="true" /> if an item was read; otherwise, <see langword="false" />.</returns>
</member>
<member name="M:System.Threading.Channels.ChannelReader`1.WaitToReadAsync(System.Threading.CancellationToken)">
<summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when data is available to read.</summary>
<param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
<returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when data is available to read
or with a <see langword="false" /> result when no further data will ever be available to be read due to the channel completing successfully.
If the channel completes with an exception, the task will also complete with an exception.
.</returns>
</member>
<member name="T:System.Threading.Channels.ChannelWriter`1">
<summary>Provides a base class for writing to a channel.</summary>
<typeparam name="T">Specifies the type of data that may be written to the channel.</typeparam>
</member>
<member name="M:System.Threading.Channels.ChannelWriter`1.#ctor">
<summary>Initializes an instance of the <see cref="T:System.Threading.Channels.ChannelWriter`1" /> class.</summary>
</member>
<member name="M:System.Threading.Channels.ChannelWriter`1.Complete(System.Exception)">
<summary>Mark the channel as being complete, meaning no more items will be written to it.</summary>
<param name="error">Optional Exception indicating a failure that's causing the channel to complete.</param>
<exception cref="T:System.InvalidOperationException">The channel has already been marked as complete.</exception>
</member>
<member name="M:System.Threading.Channels.ChannelWriter`1.TryComplete(System.Exception)">
<summary>Attempts to mark the channel as being completed, meaning no more data will be written to it.</summary>
<param name="error">An <see cref="T:System.Exception" /> indicating the failure causing no more data to be written, or null for success.</param>
<returns>
<see langword="true" /> if this operation successfully completes the channel; otherwise, <see langword="false" /> if the channel could not be marked for completion,
for example due to having already been marked as such, or due to not supporting completion.
.</returns>
</member>
<member name="M:System.Threading.Channels.ChannelWriter`1.TryWrite(`0)">
<summary>Attempts to write the specified item to the channel.</summary>
<param name="item">The item to write.</param>
<returns>
<see langword="true" /> if the item was written; otherwise, <see langword="false" />.</returns>
</member>
<member name="M:System.Threading.Channels.ChannelWriter`1.WaitToWriteAsync(System.Threading.CancellationToken)">
<summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when space is available to write an item.</summary>
<param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
<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
or with a <see langword="false" /> result when no further writing will be permitted.</returns>
</member>
<member name="M:System.Threading.Channels.ChannelWriter`1.WriteAsync(`0,System.Threading.CancellationToken)">
<summary>Asynchronously writes an item to the channel.</summary>
<param name="item">The value to write to the channel.</param>
<param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the write operation.</param>
<returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> that represents the asynchronous write operation.</returns>
</member>
<member name="T:System.Threading.Channels.UnboundedChannelOptions">
<summary>Provides options that control the behavior of unbounded <see cref="T:System.Threading.Channels.Channel`1" /> instances.</summary>
</member>
<member name="M:System.Threading.Channels.UnboundedChannelOptions.#ctor">
<summary>Initializes a new instance of the <see cref="T:System.Threading.Channels.UnboundedChannelOptions" /> class.</summary>
</member>
</members>
</doc>