1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Threading.Tasks.Dataflow</name>
6 <member name="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions">
7 <summary>Provides options used to configure a link between dataflow blocks.</summary>
9 <member name="M:System.Threading.Tasks.Dataflow.DataflowLinkOptions.#ctor">
10 <summary>Initializes the <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see>.</summary>
12 <member name="P:System.Threading.Tasks.Dataflow.DataflowLinkOptions.Append">
13 <summary>Gets or sets whether the link should be appended to the source’s list of links, or whether it should be prepended.</summary>
14 <returns>Returns <see cref="System.Boolean"></see>.</returns>
16 <member name="P:System.Threading.Tasks.Dataflow.DataflowLinkOptions.MaxMessages">
17 <summary>Gets or sets the maximum number of messages that may be consumed across the link.</summary>
18 <returns>Returns <see cref="System.Int32"></see>.</returns>
20 <member name="P:System.Threading.Tasks.Dataflow.DataflowLinkOptions.PropagateCompletion">
21 <summary>Gets or sets whether the linked target will have completion and faulting notification propagated to it automatically.</summary>
22 <returns>Returns <see cref="System.Boolean"></see>.</returns>
24 <member name="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader">
25 <summary>Provides a container of data attributes for passing between dataflow blocks.</summary>
27 <member name="M:System.Threading.Tasks.Dataflow.DataflowMessageHeader.#ctor(System.Int64)">
28 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> with the specified attributes.</summary>
29 <param name="id">The ID of the message. Must be unique within the originating source block. It does not need to be globally unique.</param>
31 <member name="M:System.Threading.Tasks.Dataflow.DataflowMessageHeader.Equals(System.Object)">
32 <summary>Checks boxed <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instances for equality by ID.</summary>
33 <param name="obj">A boxed <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</param>
34 <returns>true if the instances are equal; otherwise, false.</returns>
36 <member name="M:System.Threading.Tasks.Dataflow.DataflowMessageHeader.Equals(System.Threading.Tasks.Dataflow.DataflowMessageHeader)">
37 <summary>Checks two <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instances for equality by ID without boxing.</summary>
38 <param name="other">Another <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</param>
39 <returns>true if the instances are equal; otherwise, false.</returns>
41 <member name="M:System.Threading.Tasks.Dataflow.DataflowMessageHeader.GetHashCode">
42 <summary>Generates a hash code for the <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</summary>
43 <returns>The hash code.</returns>
45 <member name="P:System.Threading.Tasks.Dataflow.DataflowMessageHeader.Id">
46 <summary>Gets the ID of the message within the source.</summary>
47 <returns>The ID contained in the <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</returns>
49 <member name="P:System.Threading.Tasks.Dataflow.DataflowMessageHeader.IsValid">
50 <summary>Gets the validity of the message.</summary>
51 <returns>true if the ID of the message is different from 0. false if the ID of the message is 0.</returns>
53 <member name="M:System.Threading.Tasks.Dataflow.DataflowMessageHeader.op_Equality(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.DataflowMessageHeader)">
54 <summary>Checks two <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instances for equality by ID.</summary>
55 <param name="left">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</param>
56 <param name="right">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</param>
57 <returns>true if the instances are equal; otherwise, false.</returns>
59 <member name="M:System.Threading.Tasks.Dataflow.DataflowMessageHeader.op_Inequality(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.DataflowMessageHeader)">
60 <summary>Checks two <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instances for non-equality by ID.</summary>
61 <param name="left">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</param>
62 <param name="right">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance.</param>
63 <returns>true if the instances are not equal; otherwise, false.</returns>
65 <member name="T:System.Threading.Tasks.Dataflow.DataflowMessageStatus">
66 <summary>Represents the status of a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> when passed between dataflow blocks.</summary>
68 <member name="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted">
69 <summary>Indicates that the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> accepted the message. Once a target has accepted a message, it is wholly owned by the target.</summary>
72 <member name="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined">
73 <summary>Indicates that the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> declined the message. The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> still owns the message.</summary>
76 <member name="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently">
77 <summary>Indicates that the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> declined the message. The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> still owns the message.
78 Additionally, the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> will decline all future messages sent by the source.</summary>
81 <member name="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable">
82 <summary>Indicates that the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> tried to accept the message from the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>, but the message was no longer available.</summary>
85 <member name="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed">
86 <summary>Indicates that the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> postponed the message for potential consumption at a later time.
87 The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> still owns the message.</summary>
90 <member name="T:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions">
91 <summary>Provides options used to configure the processing performed by dataflow blocks that process each message through the invocation of a user-provided delegate. These are dataflow blocks such as <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see> and <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see>.</summary>
93 <member name="M:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.#ctor">
94 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions"></see>.</summary>
96 <member name="P:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism">
97 <summary>Gets the maximum number of messages that may be processed by the block concurrently.</summary>
98 <returns>The maximum number of messages.</returns>
100 <member name="P:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.SingleProducerConstrained">
101 <summary>Gets whether code using the dataflow block is constrained to one producer at a time.</summary>
102 <returns>Returns <see cref="System.Boolean"></see>.</returns>
104 <member name="T:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions">
105 <summary>Provides options used to configure the processing performed by dataflow blocks that group together multiple messages. These are dataflow blocks such as <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`2"></see> and <see cref="T:System.Threading.Tasks.Dataflow.BatchBlock`1"></see>.</summary>
107 <member name="M:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions.#ctor">
108 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions"></see>.</summary>
110 <member name="P:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions.Greedy">
111 <summary>Gets or sets the Boolean value to use to determine whether to greedily consume offered messages.</summary>
112 <returns>true to greedily consume offered messages; otherwise, false.</returns>
114 <member name="P:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions.MaxNumberOfGroups">
115 <summary>Gets or sets the maximum number of groups that should be generated by the block.</summary>
116 <returns>The maximum number of groups.</returns>
118 <member name="T:System.Threading.Tasks.Dataflow.IDataflowBlock">
119 <summary>Represents a dataflow block.</summary>
121 <member name="M:System.Threading.Tasks.Dataflow.IDataflowBlock.Complete">
122 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
124 <member name="P:System.Threading.Tasks.Dataflow.IDataflowBlock.Completion">
125 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
126 <returns>The task.</returns>
128 <member name="M:System.Threading.Tasks.Dataflow.IDataflowBlock.Fault(System.Exception)">
129 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
130 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
131 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
133 <member name="T:System.Threading.Tasks.Dataflow.IPropagatorBlock`2">
134 <summary>Represents a dataflow block that is both a target for data and a source of data.</summary>
135 <typeparam name="TInput">Specifies the type of data accepted by the <see cref="T:System.Threading.Tasks.Dataflow.IPropagatorBlock`2"></see>.</typeparam>
136 <typeparam name="TOutput">Specifies the type of data supplied by the <see cref="T:System.Threading.Tasks.Dataflow.IPropagatorBlock`2"></see>.</typeparam>
138 <member name="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1">
139 <summary>Represents a dataflow block that supports receiving messages without linking.</summary>
140 <typeparam name="TOutput">Specifies the type of data supplied by the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</typeparam>
142 <member name="M:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1.TryReceive(System.Predicate{`0},`0@)">
143 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
144 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
145 <param name="item">The item received from the source.</param>
146 <returns>true if an item could be received; otherwise, false.</returns>
148 <member name="M:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1.TryReceiveAll(System.Collections.Generic.IList{`0}@)">
149 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
150 <param name="items">The items received from the source.</param>
151 <returns>true if one or more items could be received; otherwise, false.</returns>
153 <member name="T:System.Threading.Tasks.Dataflow.ISourceBlock`1">
154 <summary>Represents a dataflow block that is a source of data.</summary>
155 <typeparam name="TOutput">Specifies the type of data supplied by the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</typeparam>
157 <member name="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)">
158 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a T:System.Threading.Tasks.Dataflow.DataflowMessageHeader previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
159 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
160 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
161 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
162 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as <paramref name="messageValue">messageValue</paramref> through <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>.
163 If the message requested is not available, the return value will be null.</returns>
164 <exception cref="T:System.ArgumentException">The messageHeader is not valid.</exception>
165 <exception cref="T:System.ArgumentNullException">The target is null.</exception>
167 <member name="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
168 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</summary>
169 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
170 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
171 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
172 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
174 <member name="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
175 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
176 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
177 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
178 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
179 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
180 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
182 <member name="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
183 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
184 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
185 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
186 <returns>true if the message was successfully reserved; otherwise, false.</returns>
187 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
188 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
190 <member name="T:System.Threading.Tasks.Dataflow.ITargetBlock`1">
191 <summary>Represents a dataflow block that is a target for data.</summary>
192 <typeparam name="TInput">Specifies the type of data accepted by the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</typeparam>
194 <member name="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
195 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
196 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
197 <param name="messageValue">The value of the message being offered.</param>
198 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
199 <param name="consumeToAccept">Set to true to instruct the target to call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
200 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
201 If the target would have otherwise postponed message, but source was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
202 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
203 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
204 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
205 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
207 <member name="T:System.Threading.Tasks.Dataflow.JoinBlock`2">
208 <summary>Provides a dataflow block that joins across multiple dataflow sources, not necessarily of the same type, waiting for one item to arrive for each type before they’re all released together as a tuple consisting of one item per type.</summary>
209 <typeparam name="T1">Specifies the type of data accepted by the block&#39;s first target.</typeparam>
210 <typeparam name="T2">Specifies the type of data accepted by the block&#39;s second target.</typeparam>
212 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.#ctor">
213 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`2"></see>.</summary>
215 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.#ctor(System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions)">
216 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`2"></see>.</summary>
217 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`2"></see>.</param>
218 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
220 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.Complete">
221 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
223 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`2.Completion">
224 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
225 <returns>The task.</returns>
227 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1}},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
228 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
229 <param name="target">Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</param>
230 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
231 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
232 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
234 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`2.OutputCount">
235 <summary>Gets the number of output items available to be received from this block.</summary>
236 <returns>The number of output items.</returns>
238 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`2.Target1">
239 <summary>Gets a target that may be used to offer messages of the first type.</summary>
240 <returns>The target.</returns>
242 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`2.Target2">
243 <summary>Gets a target that may be used to offer messages of the second type.</summary>
244 <returns>The target.</returns>
246 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.ToString">
247 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
248 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
250 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.TryReceive(System.Predicate{System.Tuple{`0,`1}},System.Tuple{`0,`1}@)">
251 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
252 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
253 <param name="item">The item received from the source.</param>
254 <returns>true if an item could be received; otherwise, false.</returns>
256 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.TryReceiveAll(System.Collections.Generic.IList{System.Tuple{`0,`1}}@)">
257 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
258 <param name="items">The items received from the source.</param>
259 <returns>true if one or more items could be received; otherwise, false.</returns>
261 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
262 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
263 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
264 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
266 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{T1@T2}}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1}},System.Boolean@)">
267 <param name="messageHeader"></param>
268 <param name="target"></param>
269 <param name="messageConsumed"></param>
272 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{T1@T2}}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1}})">
273 <param name="messageHeader"></param>
274 <param name="target"></param>
276 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{T1@T2}}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1}})">
277 <param name="messageHeader"></param>
278 <param name="target"></param>
281 <member name="T:System.Threading.Tasks.Dataflow.JoinBlock`3">
282 <summary>Provides a dataflow block that joins across multiple dataflow sources, which are not necessarily of the same type, waiting for one item to arrive for each type before they’re all released together as a tuple that contains one item per type.</summary>
283 <typeparam name="T1">Specifies the type of data accepted by the block&#39;s first target.</typeparam>
284 <typeparam name="T2">Specifies the type of data accepted by the block&#39;s second target.</typeparam>
285 <typeparam name="T3">Specifies the type of data accepted by the block&#39;s third target.</typeparam>
287 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.#ctor">
288 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`3"></see>.</summary>
290 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.#ctor(System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions)">
291 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`3"></see>.</summary>
292 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.JoinBlock`2"></see>.</param>
293 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
295 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.Complete">
296 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
298 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`3.Completion">
299 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
300 <returns>The task.</returns>
302 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1,`2}},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
303 <summary>Links the source block to the specified target block.</summary>
304 <param name="target">The target block to which to connect this source.</param>
305 <param name="linkOptions">An object that configures the link.</param>
306 <returns>A disposable object that unlinks the source from the target when its <see cref="System.IDisposable.Dispose"></see> method is called.</returns>
307 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null.
309 <paramref name="linkOptions">linkOptions</paramref> is null.</exception>
311 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`3.OutputCount">
312 <summary>Gets the number of output items available to be received from this block.</summary>
313 <returns>The number of output items.</returns>
315 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`3.Target1">
316 <summary>Gets a target that may be used to offer messages of the first type.</summary>
317 <returns>The target.</returns>
319 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`3.Target2">
320 <summary>Gets a target that may be used to offer messages of the second type.</summary>
321 <returns>The target.</returns>
323 <member name="P:System.Threading.Tasks.Dataflow.JoinBlock`3.Target3">
324 <summary>Gets a target that may be used to offer messages of the third type.</summary>
325 <returns>The target.</returns>
327 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.ToString">
328 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
329 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
331 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.TryReceive(System.Predicate{System.Tuple{`0,`1,`2}},System.Tuple{`0,`1,`2}@)">
332 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
333 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
334 <param name="item">The item received from the source.</param>
335 <returns>true if an item could be received; otherwise, false.</returns>
337 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.TryReceiveAll(System.Collections.Generic.IList{System.Tuple{`0,`1,`2}}@)">
338 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
339 <param name="items">The items received from the source.</param>
340 <returns>true if one or more items could be received; otherwise, false.</returns>
342 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
343 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
344 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
345 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
347 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{T1@T2@T3}}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1,`2}},System.Boolean@)">
348 <param name="messageHeader"></param>
349 <param name="target"></param>
350 <param name="messageConsumed"></param>
353 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{T1@T2@T3}}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1,`2}})">
354 <param name="messageHeader"></param>
355 <param name="target"></param>
357 <member name="M:System.Threading.Tasks.Dataflow.JoinBlock`3.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{T1@T2@T3}}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{`0,`1,`2}})">
358 <param name="messageHeader"></param>
359 <param name="target"></param>
362 <member name="T:System.Threading.Tasks.Dataflow.TransformBlock`2">
363 <summary>Provides a dataflow block that invokes a provided <see cref="T:System.Func`2"></see> delegate for every data element received.</summary>
364 <typeparam name="TInput">Specifies the type of data received and operated on by this <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see>.</typeparam>
365 <typeparam name="TOutput">Specifies the type of data output by this <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see>.</typeparam>
367 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.#ctor(System.Func{`0,System.Threading.Tasks.Task{`1}})">
368 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see> with the specified <see cref="T:System.Func`2"></see>.</summary>
369 <param name="transform">The function to invoke with each data element received.</param>
370 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.</exception>
372 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.#ctor(System.Func{`0,`1})">
373 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see> with the specified <see cref="T:System.Func`2"></see>.</summary>
374 <param name="transform">The function to invoke with each data element received.</param>
375 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.</exception>
377 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.#ctor(System.Func{`0,System.Threading.Tasks.Task{`1}},System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions)">
378 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see> with the specified <see cref="T:System.Func`2"></see> and <see cref="T:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions"></see>.</summary>
379 <param name="transform">The function to invoke with each data element received.</param>
380 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see>.</param>
381 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.
383 The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
385 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.#ctor(System.Func{`0,`1},System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions)">
386 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see> with the specified <see cref="T:System.Func`2"></see> and <see cref="T:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions"></see>.</summary>
387 <param name="transform">The function to invoke with each data element received.</param>
388 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.TransformBlock`2"></see>.</param>
389 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.
391 The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
393 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.Complete">
394 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
396 <member name="P:System.Threading.Tasks.Dataflow.TransformBlock`2.Completion">
397 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
398 <returns>The task.</returns>
400 <member name="P:System.Threading.Tasks.Dataflow.TransformBlock`2.InputCount">
401 <summary>Gets the number of input items waiting to be processed by this block.</summary>
402 <returns>The number of input items.</returns>
404 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`1},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
405 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
406 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
407 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
408 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
409 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
411 <member name="P:System.Threading.Tasks.Dataflow.TransformBlock`2.OutputCount">
412 <summary>Gets the number of output items available to be received from this block.</summary>
413 <returns>The number of output items.</returns>
415 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.ToString">
416 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
417 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
419 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.TryReceive(System.Predicate{`1},`1@)">
420 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
421 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
422 <param name="item">The item received from the source.</param>
423 <returns>true if an item could be received; otherwise, false.</returns>
425 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.TryReceiveAll(System.Collections.Generic.IList{`1}@)">
426 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
427 <param name="items">The items received from the source.</param>
428 <returns>true if one or more items could be received; otherwise, false.</returns>
430 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
431 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
432 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
433 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
435 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{TOutput}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`1},System.Boolean@)">
436 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
437 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
438 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
439 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
440 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as <paramref name="messageValue">messageValue</paramref> through <see cref="System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#ITargetBlock{TInput}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>.
441 If the message requested is not available, the return value will be null.</returns>
442 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
443 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
445 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{TOutput}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`1})">
446 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
447 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
448 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
449 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
450 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
451 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
453 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{TOutput}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`1})">
454 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
455 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
456 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
457 <returns>true if the message was successfully reserved; otherwise, false.</returns>
458 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
459 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
461 <member name="M:System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#ITargetBlock{TInput}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
462 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
463 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
464 <param name="messageValue">The value of the message being offered.</param>
465 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
466 <param name="consumeToAccept">true if the target must call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.TransformBlock`2.System#Threading#Tasks#Dataflow#ITargetBlock{TInput}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
467 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
468 If the target would have otherwise postponed but source was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
469 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
470 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
471 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
472 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
474 <member name="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2">
475 <summary>Provides a dataflow block that invokes a provided <see cref="T:System.Func`2"></see> delegate for every data element received.</summary>
476 <typeparam name="TInput">Specifies the type of data received and operated on by this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</typeparam>
477 <typeparam name="TOutput">Specifies the type of data output by this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</typeparam>
479 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.#ctor(System.Func{`0,System.Collections.Generic.IEnumerable{`1}})">
480 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see> with the specified function.</summary>
481 <param name="transform">The function to invoke with each data element received. All of the data from the returned <see cref="T:System.Collections.Generic.IEnumerable`1"></see> will be made available as output from this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</param>
482 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.</exception>
484 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.#ctor(System.Func{`0,System.Threading.Tasks.Task{System.Collections.Generic.IEnumerable{`1}}})">
485 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see> with the specified function.</summary>
486 <param name="transform">The function to invoke with each data element received. All of the data asynchronously returned in the <see cref="T:System.Collections.Generic.IEnumerable`1"></see> will be made available as output from this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</param>
487 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.</exception>
489 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.#ctor(System.Func{`0,System.Collections.Generic.IEnumerable{`1}},System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions)">
490 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see> with the specified function and <see cref="T:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions"></see>.</summary>
491 <param name="transform">The function to invoke with each data element received. All of the data from the returned in the <see cref="T:System.Collections.Generic.IEnumerable`1"></see> will be made available as output from this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</param>
492 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</param>
493 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.
495 The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
497 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.#ctor(System.Func{`0,System.Threading.Tasks.Task{System.Collections.Generic.IEnumerable{`1}}},System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions)">
498 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see> with the specified function and <see cref="T:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions"></see>.</summary>
499 <param name="transform">The function to invoke with each data element received. All of the data asynchronously returned in the <see cref="T:System.Collections.Generic.IEnumerable`1"></see> will be made available as output from this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</param>
500 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.TransformManyBlock`2"></see>.</param>
501 <exception cref="T:System.ArgumentNullException">The <paramref name="transform">transform</paramref> is null.
503 The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
505 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.Complete">
506 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
508 <member name="P:System.Threading.Tasks.Dataflow.TransformManyBlock`2.Completion">
509 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
510 <returns>The task.</returns>
512 <member name="P:System.Threading.Tasks.Dataflow.TransformManyBlock`2.InputCount">
513 <summary>Gets the number of input items waiting to be processed by this block.</summary>
514 <returns>The number of input items.</returns>
516 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`1},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
517 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
518 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
519 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
520 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
521 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
523 <member name="P:System.Threading.Tasks.Dataflow.TransformManyBlock`2.OutputCount">
524 <summary>Gets the number of output items available to be received from this block.</summary>
525 <returns>The number of output items.</returns>
527 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.ToString">
528 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
529 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
531 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.TryReceive(System.Predicate{`1},`1@)">
532 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
533 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
534 <param name="item">The item received from the source.</param>
535 <returns>true if an item could be received; otherwise, false.</returns>
537 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.TryReceiveAll(System.Collections.Generic.IList{`1}@)">
538 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
539 <param name="items">The items received from the source.</param>
540 <returns>true if one or more items could be received; otherwise, false.</returns>
542 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
543 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
544 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
545 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
547 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{TOutput}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`1},System.Boolean@)">
548 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
549 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
550 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
551 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
552 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as <paramref name="messageValue">messageValue</paramref> through OfferMessage <see cref="System.Threading.Tasks.Dataflow.TransformManyBlock`2.System#Threading#Tasks#Dataflow#ITargetBlock{TInput}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>
553 If the message requested is not available, the return value will be null.</returns>
554 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
555 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
557 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{TOutput}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`1})">
558 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
559 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
560 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
561 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
562 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
563 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
565 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{TOutput}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`1})">
566 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
567 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
568 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
569 <returns>true if the message was successfully reserved; otherwise, false.</returns>
570 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
571 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
573 <member name="M:System.Threading.Tasks.Dataflow.TransformManyBlock`2.System#Threading#Tasks#Dataflow#ITargetBlock{TInput}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
574 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
575 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
576 <param name="messageValue">The value of the message being offered.</param>
577 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
578 <param name="consumeToAccept">true if the target must call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
579 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, as it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
580 If the target would have otherwise postponed but source was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
581 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
582 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
583 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
585 <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
587 <member name="T:System.Threading.Tasks.Dataflow.WriteOnceBlock`1">
588 <summary>Provides a buffer for receiving and storing at most one element in a network of dataflow blocks.</summary>
589 <typeparam name="T">Specifies the type of the data buffered by this dataflow block.</typeparam>
591 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.#ctor(System.Func{`0,`0})">
592 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.WriteOnceBlock`1"></see>.</summary>
593 <param name="cloningFunction">The function to use to clone the data when offered to other blocks.</param>
595 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.#ctor(System.Func{`0,`0},System.Threading.Tasks.Dataflow.DataflowBlockOptions)">
596 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.WriteOnceBlock`1"></see> with the specified <see cref="T:System.Threading.Tasks.Dataflow.DataflowBlockOptions"></see>.</summary>
597 <param name="cloningFunction">The function to use to clone the data when offered to other blocks.</param>
598 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.WriteOnceBlock`1"></see>.</param>
599 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
601 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.Complete">
602 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
604 <member name="P:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.Completion">
605 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
606 <returns>The task.</returns>
608 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
609 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
610 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
611 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
612 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
613 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
615 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.ToString">
616 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
617 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
619 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.TryReceive(System.Predicate{`0},`0@)">
620 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
621 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
622 <param name="item">The item received from the source.</param>
623 <returns>true if an item could be received; otherwise, false.</returns>
625 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
626 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
627 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
628 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
630 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.System#Threading#Tasks#Dataflow#IReceivableSourceBlock{T}#TryReceiveAll(System.Collections.Generic.IList{`0}@)">
631 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
632 <param name="items">The items received from the source.</param>
633 <returns>true if one or more items could be received; otherwise, false.</returns>
635 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)">
636 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
637 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
638 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
639 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
640 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as <paramref name="messageValue">messageValue</paramref> through <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>.
641 If the message requested is not available, the return value will be null.</returns>
642 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
643 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
645 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
646 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
647 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
648 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
649 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
650 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
651 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
653 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
654 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
655 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
656 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
657 <returns>true if the message was successfully reserved; otherwise, false.</returns>
658 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
659 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
661 <member name="M:System.Threading.Tasks.Dataflow.WriteOnceBlock`1.System#Threading#Tasks#Dataflow#ITargetBlock{T}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
662 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
663 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
664 <param name="messageValue">The value of the message being offered.</param>
665 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
666 <param name="consumeToAccept">Set to true to instruct the target to call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
667 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
668 If the target would have otherwise postponed message, but <paramref name="source">source</paramref> was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
669 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
670 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
671 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
672 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
674 <member name="T:System.Threading.Tasks.Dataflow.ActionBlock`1">
675 <summary>Provides a dataflow block that invokes a provided <see cref="T:System.Action`1"></see> delegate for every data element received.</summary>
676 <typeparam name="TInput">The type of data that this <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see> operates on.</typeparam>
678 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.#ctor(System.Action{`0})">
679 <summary>Initializes a new instance of the <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see> class with the specified action.</summary>
680 <param name="action">The action to invoke with each data element received.</param>
681 <exception cref="T:System.ArgumentNullException"><paramref name="action">action</paramref> is null.</exception>
683 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.#ctor(System.Func{`0,System.Threading.Tasks.Task})">
684 <summary>Initializes a new instance of the <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see> class with the specified action.</summary>
685 <param name="action">The action to invoke with each data element received.</param>
686 <exception cref="T:System.ArgumentNullException"><paramref name="action">action</paramref> is null.</exception>
688 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.#ctor(System.Action{`0},System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions)">
689 <summary>Initializes a new instance of the <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see> class with the specified action and configuration options.</summary>
690 <param name="action">The action to invoke with each data element received.</param>
691 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see>.</param>
692 <exception cref="T:System.ArgumentNullException"><paramref name="action">action</paramref> is null.
694 <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
696 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.#ctor(System.Func{`0,System.Threading.Tasks.Task},System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions)">
697 <summary>Initializes a new instance of the <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see> class with the specified action and configuration options.</summary>
698 <param name="action">The action to invoke with each data element received.</param>
699 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.ActionBlock`1"></see>.</param>
700 <exception cref="T:System.ArgumentNullException"><paramref name="action">action</paramref> is null.
702 <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
704 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.Complete">
705 <summary>Signals to the dataflow block that it shouldn&#39;t accept or produce any more messages and shouldn&#39;t consume any more postponed messages.</summary>
707 <member name="P:System.Threading.Tasks.Dataflow.ActionBlock`1.Completion">
708 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> object that represents the asynchronous operation and completion of the dataflow block.</summary>
709 <returns>The completed task.</returns>
711 <member name="P:System.Threading.Tasks.Dataflow.ActionBlock`1.InputCount">
712 <summary>Gets the number of input items waiting to be processed by this block.</summary>
713 <returns>The number of input items waiting to be processed by this block.</returns>
715 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.Post(`0)">
716 <summary>Posts an item to the target dataflow block.</summary>
717 <param name="item">The item being offered to the target.</param>
718 <returns>true if the item is posted to the dataflow block; otherwise, false.</returns>
720 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.ToString">
721 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
722 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
724 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
725 <summary>Causes the dataflow block to complete in a faulted state.</summary>
726 <param name="exception">The exception that caused the faulting.</param>
727 <exception cref="T:System.ArgumentNullException"><paramref name="exception">exception</paramref> is null.</exception>
729 <member name="M:System.Threading.Tasks.Dataflow.ActionBlock`1.System#Threading#Tasks#Dataflow#ITargetBlock{TInput}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
730 <summary>Offers a message to the dataflow block, and gives it the opportunity to consume or postpone the message.</summary>
731 <param name="messageHeader">The header of the message being offered.</param>
732 <param name="messageValue">The value of the message being offered.</param>
733 <param name="source">The dataflow block that is offering the message. This may be null.</param>
734 <param name="consumeToAccept">true to instruct the target to call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message; otherwise, false.</param>
735 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
736 If the target would have otherwise postponed message, but source was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned.
737 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
738 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
739 <exception cref="T:System.ArgumentException"><paramref name="messageHeader">messageHeader</paramref> is not valid.
740 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may be true only if provided with a non-null <paramref name="source">source</paramref>.</exception>
742 <member name="T:System.Threading.Tasks.Dataflow.BatchBlock`1">
743 <summary>Provides a dataflow block that batches inputs into arrays.</summary>
744 <typeparam name="T">Specifies the type of data put into batches.</typeparam>
746 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.#ctor(System.Int32)">
747 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchBlock`1"></see> with the specified batch size.</summary>
748 <param name="batchSize">The number of items to group into a batch.</param>
749 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="batchSize">batchSize</paramref> must be positive.</exception>
751 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.#ctor(System.Int32,System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions)">
752 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchBlock`1"></see> with the specified batch size, declining option, and block options.</summary>
753 <param name="batchSize">The number of items to group into a batch.</param>
754 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.BatchBlock`1"></see>.</param>
755 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="batchSize">batchSize</paramref> must be positive.
757 The <paramref name="batchSize">batchSize</paramref> must be smaller than the value of the <see cref="System.Threading.Tasks.Dataflow.DataflowBlockOptions.BoundedCapacity"></see> option if a non-default value has been set.</exception>
758 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
760 <member name="P:System.Threading.Tasks.Dataflow.BatchBlock`1.BatchSize">
761 <summary>Gets the size of the batches generated by this <see cref="T:System.Threading.Tasks.Dataflow.BatchBlock`1"></see>.</summary>
762 <returns>The batch size.</returns>
764 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.Complete">
765 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
767 <member name="P:System.Threading.Tasks.Dataflow.BatchBlock`1.Completion">
768 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
769 <returns>The task.</returns>
771 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`0[]},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
772 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
773 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
774 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
775 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
776 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
778 <member name="P:System.Threading.Tasks.Dataflow.BatchBlock`1.OutputCount">
779 <summary>Gets the number of output items available to be received from this block.</summary>
780 <returns>The number of output items.</returns>
782 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.ToString">
783 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
784 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
786 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.TriggerBatch">
787 <summary>Triggers the <see cref="T:System.Threading.Tasks.Dataflow.BatchBlock`1"></see> to initiate a batching operation even if the number of currently queued or postponed items is less than the <see cref="P:System.Threading.Tasks.Dataflow.BatchBlock`1.BatchSize"></see>.</summary>
789 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.TryReceive(System.Predicate{`0[]},`0[]@)">
790 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
791 <param name="filter">The predicate a value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
792 <param name="item">The item received from the source.</param>
793 <returns>true if an item could be received; otherwise, false.</returns>
795 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.TryReceiveAll(System.Collections.Generic.IList{`0[]}@)">
796 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
797 <param name="items">The items received from the source.</param>
798 <returns>true if one or more items could be received; otherwise, false.</returns>
800 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
801 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
802 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
803 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
805 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T[]}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0[]},System.Boolean@)">
806 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> .</summary>
807 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
808 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
809 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
810 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as messageValue through <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>.
811 If the message requested is not available, the return value will be null.</returns>
812 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
813 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
815 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T[]}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0[]})">
816 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
817 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
818 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
819 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
820 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
821 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
823 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T[]}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0[]})">
824 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
825 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
826 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
827 <returns>true if the message was successfully reserved; otherwise, false.</returns>
828 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
829 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
831 <member name="M:System.Threading.Tasks.Dataflow.BatchBlock`1.System#Threading#Tasks#Dataflow#ITargetBlock{T}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
832 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
833 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
834 <param name="messageValue">The value of the message being offered.</param>
835 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
836 <param name="consumeToAccept">Set to true to instruct the target to call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
837 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
838 If the target would have otherwise postponed message, but <paramref name="source">source</paramref> was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
839 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
840 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
841 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
842 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
844 <member name="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2">
845 <summary>Provides a dataflow block that batches a specified number of inputs of potentially differing types provided to one or more of its targets.</summary>
846 <typeparam name="T1">Specifies the type of data accepted by the block&#39;s first target.</typeparam>
847 <typeparam name="T2">Specifies the type of data accepted by the block&#39;s second target.</typeparam>
849 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.#ctor(System.Int32)">
850 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2"></see> with the specified configuration.</summary>
851 <param name="batchSize">The number of items to group into a batch.</param>
852 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="batchSize">batchSize</paramref> must be positive.</exception>
854 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.#ctor(System.Int32,System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions)">
855 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2"></see> with the specified configuration.</summary>
856 <param name="batchSize">The number of items to group into a batch.</param>
857 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2"></see>.</param>
858 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
860 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.BatchSize">
861 <summary>Gets the size of the batches generated by this <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2"></see>.</summary>
862 <returns>The batch size.</returns>
864 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.Complete">
865 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
867 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.Completion">
868 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
869 <returns>The task.</returns>
871 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
872 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
873 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
874 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
875 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
876 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
878 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.OutputCount">
879 <summary>Gets the number of output items available to be received from this block.</summary>
880 <returns>The number of output items.</returns>
882 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.Target1">
883 <summary>Gets a target that may be used to offer messages of the first type.</summary>
884 <returns>The target.</returns>
886 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.Target2">
887 <summary>Gets a target that may be used to offer messages of the second type.</summary>
888 <returns>The target.</returns>
890 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.ToString">
891 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
892 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
894 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.TryReceive(System.Predicate{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}},System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}@)">
895 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
896 <param name="filter">The predicate a value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
897 <param name="item">The item received from the source.</param>
898 <returns>true if an item could be received; otherwise, false.</returns>
900 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.TryReceiveAll(System.Collections.Generic.IList{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}}@)">
901 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
902 <param name="items">The items received from the source.</param>
903 <returns>true if one or more items could be received; otherwise, false.</returns>
905 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
906 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
907 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
908 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
910 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{System#Collections#Generic#IList{T1}@System#Collections#Generic#IList{T2}}}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}},System.Boolean@)">
911 <param name="messageHeader"></param>
912 <param name="target"></param>
913 <param name="messageConsumed"></param>
916 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{System#Collections#Generic#IList{T1}@System#Collections#Generic#IList{T2}}}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}})">
917 <param name="messageHeader"></param>
918 <param name="target"></param>
920 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{System#Collections#Generic#IList{T1}@System#Collections#Generic#IList{T2}}}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1}}})">
921 <param name="messageHeader"></param>
922 <param name="target"></param>
925 <member name="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3">
926 <summary>Provides a dataflow block that batches a specified number of inputs of potentially differing types provided to one or more of its targets.</summary>
927 <typeparam name="T1">Specifies the type of data accepted by the block&#39;s first target.</typeparam>
928 <typeparam name="T2">Specifies the type of data accepted by the block&#39;s second target.</typeparam>
929 <typeparam name="T3">Specifies the type of data accepted by the block&#39;s third target.</typeparam>
931 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.#ctor(System.Int32)">
932 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3"></see> with the specified configuration.</summary>
933 <param name="batchSize">The number of items to group into a batch.</param>
934 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="batchSize">batchSize</paramref> must be positive.</exception>
936 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.#ctor(System.Int32,System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions)">
937 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3"></see> with the specified configuration.</summary>
938 <param name="batchSize">The number of items to group into a batch.</param>
939 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2"></see>.</param>
940 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="batchSize">batchSize</paramref> must be positive.</exception>
941 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
943 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.BatchSize">
944 <summary>Gets the size of the batches generated by this <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3"></see>.</summary>
945 <returns>The batch size.</returns>
947 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.Complete">
948 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
950 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.Completion">
951 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
952 <returns>The task.</returns>
954 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
955 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> .</summary>
956 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
957 <param name="linkOptions">true if the source should unlink from the target after successfully propagating a single message; false to remain connected even after a single message has been propagated.</param>
958 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
959 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
961 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.OutputCount">
962 <summary>Gets the number of output items available to be received from this block.</summary>
963 <returns>The number of output items.</returns>
965 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.Target1">
966 <summary>Gets a target that may be used to offer messages of the first type.</summary>
967 <returns>The target.</returns>
969 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.Target2">
970 <summary>Gets a target that may be used to offer messages of the second type.</summary>
971 <returns>The target.</returns>
973 <member name="P:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.Target3">
974 <summary>Gets a target that may be used to offer messages of the third type.</summary>
975 <returns>The target.</returns>
977 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.ToString">
978 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
979 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
981 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.TryReceive(System.Predicate{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}},System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}@)">
982 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
983 <param name="filter">The predicate a value must successfully pass in order for it to be received. filter may be null in which case all items will pass.</param>
984 <param name="item">The item received from the source.</param>
985 <returns>true if an item could be received; otherwise, false.</returns>
987 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.TryReceiveAll(System.Collections.Generic.IList{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}}@)">
988 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
989 <param name="items">The items received from the source.</param>
990 <returns>true if one or more items could be received; otherwise, false.</returns>
992 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
993 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
994 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
995 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
997 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{System#Collections#Generic#IList{T1}@System#Collections#Generic#IList{T2}@System#Collections#Generic#IList{T3}}}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}},System.Boolean@)">
998 <param name="messageHeader"></param>
999 <param name="target"></param>
1000 <param name="messageConsumed"></param>
1003 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{System#Collections#Generic#IList{T1}@System#Collections#Generic#IList{T2}@System#Collections#Generic#IList{T3}}}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}})">
1004 <param name="messageHeader"></param>
1005 <param name="target"></param>
1007 <member name="M:System.Threading.Tasks.Dataflow.BatchedJoinBlock`3.System#Threading#Tasks#Dataflow#ISourceBlock{System#Tuple{System#Collections#Generic#IList{T1}@System#Collections#Generic#IList{T2}@System#Collections#Generic#IList{T3}}}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{System.Tuple{System.Collections.Generic.IList{`0},System.Collections.Generic.IList{`1},System.Collections.Generic.IList{`2}}})">
1008 <param name="messageHeader"></param>
1009 <param name="target"></param>
1012 <member name="T:System.Threading.Tasks.Dataflow.BroadcastBlock`1">
1013 <summary>Provides a buffer for storing at most one element at time, overwriting each message with the next as it arrives.</summary>
1014 <typeparam name="T">Specifies the type of the data buffered by this dataflow block.</typeparam>
1016 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.#ctor(System.Func{`0,`0})">
1017 <summary>Initializes the <see cref="T:System.Threading.Tasks.Dataflow.BroadcastBlock`1"></see> with the specified cloning function.</summary>
1018 <param name="cloningFunction">The function to use to clone the data when offered to other blocks.</param>
1020 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.#ctor(System.Func{`0,`0},System.Threading.Tasks.Dataflow.DataflowBlockOptions)">
1021 <summary>Initializes the <see cref="T:System.Threading.Tasks.Dataflow.BroadcastBlock`1"></see> with the specified cloning function and <see cref="T:System.Threading.Tasks.Dataflow.DataflowBlockOptions"></see>.</summary>
1022 <param name="cloningFunction">The function to use to clone the data when offered to other blocks.</param>
1023 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.BroadcastBlock`1"></see>.</param>
1024 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
1026 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.Complete">
1027 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
1029 <member name="P:System.Threading.Tasks.Dataflow.BroadcastBlock`1.Completion">
1030 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
1031 <returns>The task.</returns>
1033 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
1034 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</summary>
1035 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
1036 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
1037 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
1038 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
1040 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.ToString">
1041 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
1042 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
1044 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.TryReceive(System.Predicate{`0},`0@)">
1045 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
1046 <param name="filter">The predicate a value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
1047 <param name="item">The item received from the source.</param>
1048 <returns>true if an item could be received; otherwise, false.</returns>
1050 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
1051 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
1052 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
1053 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
1055 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.System#Threading#Tasks#Dataflow#IReceivableSourceBlock{T}#TryReceiveAll(System.Collections.Generic.IList{`0}@)">
1056 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
1057 <param name="items">The items received from the source.</param>
1058 <returns>true if one or more items could be received; otherwise, false.</returns>
1060 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)">
1061 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1062 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
1063 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
1064 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
1065 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as <paramref name="messageValue">messageValue</paramref> through <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>.
1066 If the message requested is not available, the return value will be null.</returns>
1067 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
1068 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1070 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
1071 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1072 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
1073 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
1074 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
1075 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1076 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
1078 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
1079 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1080 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
1081 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
1082 <returns>true if the message was successfully reserved; otherwise, false.</returns>
1083 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
1084 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1086 <member name="M:System.Threading.Tasks.Dataflow.BroadcastBlock`1.System#Threading#Tasks#Dataflow#ITargetBlock{T}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
1087 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
1088 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
1089 <param name="messageValue">The value of the message being offered.</param>
1090 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
1091 <param name="consumeToAccept">Set to true to instruct the target to call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
1092 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
1093 If the target would have otherwise postponed message, but <paramref name="source">source</paramref> was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
1094 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
1095 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
1096 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
1097 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
1099 <member name="T:System.Threading.Tasks.Dataflow.BufferBlock`1">
1100 <summary>Provides a buffer for storing data.</summary>
1101 <typeparam name="T">Specifies the type of the data buffered by this dataflow block.</typeparam>
1103 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.#ctor">
1104 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BufferBlock`1"></see>.</summary>
1106 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.#ctor(System.Threading.Tasks.Dataflow.DataflowBlockOptions)">
1107 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BufferBlock`1"></see> with the specified <see cref="T:System.Threading.Tasks.Dataflow.DataflowBlockOptions"></see>.</summary>
1108 <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.BufferBlock`1"></see>.</param>
1109 <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
1111 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.Complete">
1112 <summary>Signals to the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> that it should not accept nor produce any more messages nor consume any more postponed messages.</summary>
1114 <member name="P:System.Threading.Tasks.Dataflow.BufferBlock`1.Completion">
1115 <summary>Gets a <see cref="T:System.Threading.Tasks.Task"></see> that represents the asynchronous operation and completion of the dataflow block.</summary>
1116 <returns>The task.</returns>
1118 <member name="P:System.Threading.Tasks.Dataflow.BufferBlock`1.Count">
1119 <summary>Gets the number of items currently stored in the buffer.</summary>
1120 <returns>The number of items.</returns>
1122 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.LinkTo(System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Threading.Tasks.Dataflow.DataflowLinkOptions)">
1123 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</summary>
1124 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect this source.</param>
1125 <param name="linkOptions">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowLinkOptions"></see> instance that configures the link.</param>
1126 <returns>An IDisposable that, upon calling Dispose, will unlink the source from the target.</returns>
1127 <exception cref="T:System.ArgumentNullException"><paramref name="target">target</paramref> is null (Nothing in Visual Basic) or <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).</exception>
1129 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.ToString">
1130 <summary>Returns a string that represents the formatted name of this <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</summary>
1131 <returns>A string that represents the formatted name of this <see cref="System.Threading.Tasks.Dataflow.IDataflowBlock"></see> instance.</returns>
1133 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.TryReceive(System.Predicate{`0},`0@)">
1134 <summary>Attempts to synchronously receive an available output item from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
1135 <param name="filter">The predicate value must successfully pass in order for it to be received. filter may be null, in which case all items will pass.</param>
1136 <param name="item">The item received from the source.</param>
1137 <returns>true if an item could be received; otherwise, false.</returns>
1139 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.TryReceiveAll(System.Collections.Generic.IList{`0}@)">
1140 <summary>Attempts to synchronously receive all available items from the <see cref="T:System.Threading.Tasks.Dataflow.IReceivableSourceBlock`1"></see>.</summary>
1141 <param name="items">The items received from the source.</param>
1142 <returns>true if one or more items could be received; otherwise, false.</returns>
1144 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.System#Threading#Tasks#Dataflow#IDataflowBlock#Fault(System.Exception)">
1145 <summary>Causes the <see cref="T:System.Threading.Tasks.Dataflow.IDataflowBlock"></see> to complete in a <see cref="F:System.Threading.Tasks.TaskStatus.Faulted"></see> state.</summary>
1146 <param name="exception">The <see cref="T:System.Exception"></see> that caused the faulting.</param>
1147 <exception cref="T:System.ArgumentNullException">The <paramref name="exception">exception</paramref> is null.</exception>
1149 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)">
1150 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to accept and consume a <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> previously offered by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1151 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being consumed.</param>
1152 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> consuming the message.</param>
1153 <param name="messageConsumed">true if the message was successfully consumed; otherwise, false.</param>
1154 <returns>The value of the consumed message. This may correspond to a different <see cref="System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance than was previously reserved and passed as the <paramref name="messageHeader">messageHeader</paramref> to <see cref="System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see>. The consuming <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> must use the returned value instead of the value passed as <paramref name="messageValue">messageValue</paramref> through <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>.
1155 If the message requested is not available, the return value will be null.</returns>
1156 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
1157 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1159 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ReleaseReservation(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
1160 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to release a previously reserved <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1161 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the reserved message being released.</param>
1162 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> releasing the message it previously reserved.</param>
1163 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
1164 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1165 <exception cref="T:System.InvalidOperationException">The <paramref name="target">target</paramref> did not have the message reserved.</exception>
1167 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.System#Threading#Tasks#Dataflow#ISourceBlock{T}#ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0})">
1168 <summary>Called by a linked <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to reserve a previously offered <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> by this <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1169 <param name="messageHeader">The <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> of the message being reserved.</param>
1170 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> reserving the message.</param>
1171 <returns>true if the message was successfully reserved; otherwise, false.</returns>
1172 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.</exception>
1173 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1175 <member name="M:System.Threading.Tasks.Dataflow.BufferBlock`1.System#Threading#Tasks#Dataflow#ITargetBlock{T}#OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)">
1176 <summary>Offers a message to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>, giving the target the opportunity to consume or postpone the message.</summary>
1177 <param name="messageHeader">A <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader"></see> instance that represents the header of the message being offered.</param>
1178 <param name="messageValue">The value of the message being offered.</param>
1179 <param name="source">The <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> offering the message. This may be null.</param>
1180 <param name="consumeToAccept">Set to true to instruct the target to call <see cref="M:System.Threading.Tasks.Dataflow.ISourceBlock`1.ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,System.Threading.Tasks.Dataflow.ITargetBlock{`0},System.Boolean@)"></see> synchronously during the call to <see cref="M:System.Threading.Tasks.Dataflow.ITargetBlock`1.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader,`0,System.Threading.Tasks.Dataflow.ISourceBlock{`0},System.Boolean)"></see>, prior to returning <see cref="F:System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see>, in order to consume the message.</param>
1181 <returns>The status of the offered message. If the message was accepted by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Accepted"></see> is returned, and the source should no longer use the offered message, because it is now owned by the target. If the message was postponed by the target, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Postponed"></see> is returned as a notification that the target may later attempt to consume or reserve the message; in the meantime, the source still owns the message and may offer it to other blocks.
1182 If the target would have otherwise postponed message, but <paramref name="source">source</paramref> was null, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is instead returned.
1183 If the target tried to accept the message but missed it due to the source delivering the message to another target or simply discarding it, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.NotAvailable"></see> is returned.
1184 If the target chose not to accept the message, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.Declined"></see> is returned. If the target chose not to accept the message and will never accept another message from this source, <see cref="System.Threading.Tasks.Dataflow.DataflowMessageStatus.DecliningPermanently"></see> is returned.</returns>
1185 <exception cref="T:System.ArgumentException">The <paramref name="messageHeader">messageHeader</paramref> is not valid.
1186 -or- <paramref name="consumeToAccept">consumeToAccept</paramref> may only be true if provided with a non-null <paramref name="source">source</paramref>.</exception>
1188 <member name="T:System.Threading.Tasks.Dataflow.DataflowBlock">
1189 <summary>Provides a set of static (Shared in Visual Basic) methods for working with dataflow blocks.</summary>
1191 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.AsObservable``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0})">
1192 <summary>Creates a new <see cref="T:System.IObservable`1"></see> abstraction over the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1193 <param name="source">The source to wrap.</param>
1194 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1195 <returns>An <see cref="System.IObservable`1"></see> that enables observers to be subscribed to the source.</returns>
1196 <exception cref="T:System.ArgumentNullException">The <paramref name="source">source</paramref> is null.</exception>
1198 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.AsObserver``1(System.Threading.Tasks.Dataflow.ITargetBlock{``0})">
1199 <summary>Creates a new <see cref="T:System.IObserver`1"></see> abstraction over the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</summary>
1200 <param name="target">The target to wrap.</param>
1201 <typeparam name="TInput">Specifies the type of input accepted by the target block.</typeparam>
1202 <returns>An observer that wraps the target block.</returns>
1204 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Choose``3(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Action{``0},System.Threading.Tasks.Dataflow.ISourceBlock{``1},System.Action{``1},System.Threading.Tasks.Dataflow.ISourceBlock{``2},System.Action{``2})">
1205 <summary>Monitors three dataflow sources, invoking the provided handler for whichever source makes data available first.</summary>
1206 <param name="source1">The first source.</param>
1207 <param name="action1">The handler to execute on data from the first source.</param>
1208 <param name="source2">The second source.</param>
1209 <param name="action2">The handler to execute on data from the second source.</param>
1210 <param name="source3">The third source.</param>
1211 <param name="action3">The handler to execute on data from the third source.</param>
1212 <typeparam name="T1">Specifies type of data contained in the first source.</typeparam>
1213 <typeparam name="T2">Specifies type of data contained in the second source.</typeparam>
1214 <typeparam name="T3">Specifies type of data contained in the third source.</typeparam>
1215 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that represents the asynchronous choice. If all sources are completed prior to the choice completing, the resulting task will be canceled. When one of the sources has data available and successfully propagates it to the choice, the resulting task will complete when the handler completes; if the handler throws an exception, the task will end in the <see cref="System.Threading.Tasks.TaskStatus.Faulted"></see> state and will contain the unhandled exception. Otherwise, the task will end with its <see cref="System.Threading.Tasks.Task`1.Result"></see> set to the 0-based index of the source.
1216 This method will only consume an element from one of the data sources, never more than one.</returns>
1217 <exception cref="T:System.ArgumentNullException">The <paramref name="source1">source1</paramref> is null.
1219 The <paramref name="action1">action1</paramref> is null.
1221 The <paramref name="source2">source2</paramref> is null.
1223 The <paramref name="action2">action2</paramref> is null.
1225 The <paramref name="source3">source3</paramref> is null.
1227 The <paramref name="action3">action3</paramref> is null.</exception>
1229 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Choose``3(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Action{``0},System.Threading.Tasks.Dataflow.ISourceBlock{``1},System.Action{``1},System.Threading.Tasks.Dataflow.ISourceBlock{``2},System.Action{``2},System.Threading.Tasks.Dataflow.DataflowBlockOptions)">
1230 <summary>Monitors three dataflow sources, invoking the provided handler for whichever source makes data available first.</summary>
1231 <param name="source1">The first source.</param>
1232 <param name="action1">The handler to execute on data from the first source.</param>
1233 <param name="source2">The second source.</param>
1234 <param name="action2">The handler to execute on data from the second source.</param>
1235 <param name="source3">The third source.</param>
1236 <param name="action3">The handler to execute on data from the third source.</param>
1237 <param name="dataflowBlockOptions">The options with which to configure this choice.</param>
1238 <typeparam name="T1">Specifies type of data contained in the first source.</typeparam>
1239 <typeparam name="T2">Specifies type of data contained in the second source.</typeparam>
1240 <typeparam name="T3">Specifies type of data contained in the third source.</typeparam>
1241 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that represents the asynchronous choice. If all sources are completed prior to the choice completing, or if the <see cref="System.Threading.CancellationToken"></see> provided as part of <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is canceled prior to the choice completing, the resulting task will be canceled. When one of the sources has data available and successfully propagates it to the choice, the resulting task will complete when the handler completes; if the handler throws an exception, the task will end in the <see cref="System.Threading.Tasks.TaskStatus.Faulted"></see> state and will contain the unhandled exception. Otherwise, the task will end with its <see cref="System.Threading.Tasks.Task`1.Result"></see> set to the 0-based index of the source.
1242 This method will only consume an element from one of the data sources, never more than one. If cancellation is requested after an element has been received, the cancellation request will be ignored, and the relevant handler will be allowed to execute.</returns>
1243 <exception cref="T:System.ArgumentNullException">The <paramref name="source1">source1</paramref> is null.
1245 The <paramref name="action1">action1</paramref> is null.
1247 The <paramref name="source2">source2</paramref> is null.
1249 The <paramref name="action2">action2</paramref> is null.
1251 The <paramref name="source3">source3</paramref> is null.
1253 The <paramref name="action3">action3</paramref> is null.
1255 The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
1257 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Choose``2(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Action{``0},System.Threading.Tasks.Dataflow.ISourceBlock{``1},System.Action{``1})">
1258 <summary>Monitors two dataflow sources, invoking the provided handler for whichever source makes data available first.</summary>
1259 <param name="source1">The first source.</param>
1260 <param name="action1">The handler to execute on data from the first source.</param>
1261 <param name="source2">The second source.</param>
1262 <param name="action2">The handler to execute on data from the second source.</param>
1263 <typeparam name="T1">Specifies type of data contained in the first source.</typeparam>
1264 <typeparam name="T2">Specifies type of data contained in the second source.</typeparam>
1265 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that represents the asynchronous choice. If both sources are completed prior to the choice completing, the resulting task will be canceled. When one of the sources has data available and successfully propagates it to the choice, the resulting task will complete when the handler completes; if the handler throws an exception, the task will end in the <see cref="System.Threading.Tasks.TaskStatus.Faulted"></see> state and will contain the unhandled exception. Otherwise, the task will end with its <see cref="System.Threading.Tasks.Task`1.Result"></see> set to either 0 or 1 to represent the first or second source, respectively.
1266 This method will only consume an element from one of the two data sources, never both.</returns>
1267 <exception cref="T:System.ArgumentNullException">The <paramref name="source1">source1</paramref> is null.
1269 The <paramref name="action1">action1</paramref> is null.
1271 The <paramref name="source2">source2</paramref> is null.
1273 The <paramref name="action2">action2</paramref> is null.</exception>
1275 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Choose``2(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Action{``0},System.Threading.Tasks.Dataflow.ISourceBlock{``1},System.Action{``1},System.Threading.Tasks.Dataflow.DataflowBlockOptions)">
1276 <summary>Monitors two dataflow sources, invoking the provided handler for whichever source makes data available first.</summary>
1277 <param name="source1">The first source.</param>
1278 <param name="action1">The handler to execute on data from the first source.</param>
1279 <param name="source2">The second source.</param>
1280 <param name="action2">The handler to execute on data from the second source.</param>
1281 <param name="dataflowBlockOptions">The options with which to configure this choice.</param>
1282 <typeparam name="T1">Specifies type of data contained in the first source.</typeparam>
1283 <typeparam name="T2">Specifies type of data contained in the second source.</typeparam>
1284 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that represents the asynchronous choice. If both sources are completed prior to the choice completing, or if the <see cref="System.Threading.CancellationToken"></see> provided as part of <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is canceled prior to the choice completing, the resulting task will be canceled. When one of the sources has data available and successfully propagates it to the choice, the resulting task will complete when the handler completes; if the handler throws an exception, the task will end in the <see cref="System.Threading.Tasks.TaskStatus.Faulted"></see> state and will contain the unhandled exception. Otherwise, the task will end with its <see cref="System.Threading.Tasks.Task`1.Result"></see> set to either 0 or 1 to represent the first or second source, respectively.</returns>
1285 <exception cref="T:System.ArgumentNullException">The <paramref name="source1">source1</paramref> is null.
1287 The <paramref name="action1">action1</paramref> is null.
1289 The <paramref name="source2">source2</paramref> is null.
1291 The <paramref name="action2">action2</paramref> is null.
1293 The <paramref name="dataflowBlockOptions">dataflowBlockOptions</paramref> is null.</exception>
1295 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Encapsulate``2(System.Threading.Tasks.Dataflow.ITargetBlock{``0},System.Threading.Tasks.Dataflow.ISourceBlock{``1})">
1296 <summary>Encapsulates a target and a source into a single propagator.</summary>
1297 <param name="target">The target to encapsulate.</param>
1298 <param name="source">The source to encapsulate.</param>
1299 <typeparam name="TInput">Specifies the type of input expected by the target.</typeparam>
1300 <typeparam name="TOutput">Specifies the type of output produced by the source.</typeparam>
1301 <returns>The encapsulated target and source.</returns>
1303 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.LinkTo``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Threading.Tasks.Dataflow.ITargetBlock{``0})">
1304 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</summary>
1305 <param name="source">The source from which to link.</param>
1306 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect the source.</param>
1307 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1308 <returns>An <see cref="System.IDisposable"></see> that, upon calling Dispose, will unlink the source from the target.</returns>
1309 <exception cref="T:System.ArgumentNullException">The <paramref name="source">source</paramref> is null.
1311 The <paramref name="target">target</paramref> is null.</exception>
1313 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.LinkTo``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Threading.Tasks.Dataflow.ITargetBlock{``0},System.Predicate{``0})">
1314 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> using the specified filter.</summary>
1315 <param name="source">The source from which to link.</param>
1316 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect the source.</param>
1317 <param name="predicate">The filter a message must pass in order for it to propagate from the source to the target.</param>
1318 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1319 <returns>An <see cref="System.IDisposable"></see> that, upon calling Dispose, will unlink the source from the target.</returns>
1320 <exception cref="T:System.ArgumentNullException">The <paramref name="source">source</paramref> is null.
1322 The <paramref name="target">target</paramref> is null.
1324 The <paramref name="predicate">predicate</paramref> is null.</exception>
1326 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.LinkTo``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Threading.Tasks.Dataflow.ITargetBlock{``0},System.Threading.Tasks.Dataflow.DataflowLinkOptions,System.Predicate{``0})">
1327 <summary>Links the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see> to the specified <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> using the specified filter.</summary>
1328 <param name="source">The source from which to link.</param>
1329 <param name="target">The <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> to which to connect the source.</param>
1330 <param name="linkOptions">One of the enumeration values that specifies how to configure a link between dataflow blocks.</param>
1331 <param name="predicate">The filter a message must pass in order for it to propagate from the source to the target.</param>
1332 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1333 <returns>An <see cref="System.IDisposable"></see> that, upon calling Dispose, will unlink the source from the target.</returns>
1334 <exception cref="T:System.ArgumentNullException">The <paramref name="source">source</paramref> is null (Nothing in Visual Basic).
1336 The <paramref name="target">target</paramref> is null (Nothing in Visual Basic).
1338 The <paramref name="linkOptions">linkOptions</paramref> is null (Nothing in Visual Basic).
1340 The <paramref name="predicate">predicate</paramref> is null (Nothing in Visual Basic).</exception>
1342 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.NullTarget``1">
1343 <summary>Gets a target block that synchronously accepts all messages offered to it and drops them.</summary>
1344 <typeparam name="TInput">The type of the messages this block can accept.</typeparam>
1345 <returns>A <see cref="System.Threading.Tasks.Dataflow.ITargetBlock`1"></see> that accepts and subsequently drops all offered messages.</returns>
1347 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.OutputAvailableAsync``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Threading.CancellationToken)">
1348 <summary>Provides a <see cref="T:System.Threading.Tasks.Task`1"></see> that asynchronously monitors the source for available output.</summary>
1349 <param name="source">The source to monitor.</param>
1350 <param name="cancellationToken">The cancellation token with which to cancel the asynchronous operation.</param>
1351 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1352 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that informs of whether and when more output is available. If, when the task completes, its <see cref="System.Threading.Tasks.Task`1.Result"></see> is true, more output is available in the source (though another consumer of the source may retrieve the data). If it returns false, more output is not and will never be available, due to the source completing prior to output being available.</returns>
1354 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.OutputAvailableAsync``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0})">
1355 <summary>Provides a <see cref="T:System.Threading.Tasks.Task`1"></see> that asynchronously monitors the source for available output.</summary>
1356 <param name="source">The source to monitor.</param>
1357 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1358 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that informs of whether and when more output is available. If, when the task completes, its <see cref="System.Threading.Tasks.Task`1.Result"></see> is true, more output is available in the source (though another consumer of the source may retrieve the data).
1359 If it returns false, more output is not and will never be available, due to the source completing prior to output being available.</returns>
1361 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Post``1(System.Threading.Tasks.Dataflow.ITargetBlock{``0},``0)">
1362 <summary>Posts an item to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1"></see>.</summary>
1363 <param name="target">The target block.</param>
1364 <param name="item">The item being offered to the target.</param>
1365 <typeparam name="TInput">Specifies the type of data accepted by the target block.</typeparam>
1366 <returns>true if the item was accepted by the target block; otherwise, false.</returns>
1368 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Receive``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0})">
1369 <summary>Synchronously receives a value from a specified source.</summary>
1370 <param name="source">The source from which to receive the value.</param>
1371 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1372 <returns>The received value.</returns>
1373 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1374 <exception cref="T:System.InvalidOperationException">No item could be received from the source.</exception>
1376 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Receive``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Threading.CancellationToken)">
1377 <summary>Synchronously receives a value from a specified source and provides a token to cancel the operation.</summary>
1378 <param name="source">The source from which to receive the value.</param>
1379 <param name="cancellationToken">The token to use to cancel the receive operation.</param>
1380 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1381 <returns>The received value.</returns>
1382 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1383 <exception cref="T:System.InvalidOperationException">No item could be received from the source.</exception>
1384 <exception cref="T:System.OperationCanceledException">The operation was canceled before an item was received from the source.</exception>
1386 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Receive``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.TimeSpan)">
1387 <summary>Synchronously receives a value from a specified source, observing an optional time-out period.</summary>
1388 <param name="source">The source from which to receive the value.</param>
1389 <param name="timeout">The maximum time interval, in milliseconds, to wait for the synchronous operation to complete, or an interval that represents -1 milliseconds to wait indefinitely.</param>
1390 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1391 <returns>The received value.</returns>
1392 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="timeout">timeout</paramref> is a negative number other than -1 milliseconds, which represents an infinite time-out period.
1394 <paramref name="timeout">timeout</paramref> is greater than <see cref="System.Int32.MaxValue"></see>.</exception>
1395 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1396 <exception cref="T:System.InvalidOperationException">No item could be received from the source.</exception>
1397 <exception cref="T:System.TimeoutException">The specified time-out expired before an item was received from the source.</exception>
1399 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.Receive``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.TimeSpan,System.Threading.CancellationToken)">
1400 <summary>Synchronously receives a value from a specified source, providing a token to cancel the operation and observing an optional time-out interval.</summary>
1401 <param name="source">The source from which to receive the value.</param>
1402 <param name="timeout">The maximum time interval, in milliseconds, to wait for the synchronous operation to complete, or an interval that represents -1 milliseconds to wait indefinitely.</param>
1403 <param name="cancellationToken">The token to use to cancel the receive operation.</param>
1404 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1405 <returns>The received value.</returns>
1406 <exception cref="T:System.ArgumentNullException">The <paramref name="source">source</paramref> is null.</exception>
1407 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="timeout">timeout</paramref> is a negative number other than -1 milliseconds, which represents an infinite time-out period.
1409 <paramref name="timeout">timeout</paramref> is greater than <see cref="System.Int32.MaxValue"></see>.</exception>
1410 <exception cref="T:System.InvalidOperationException">No item could be received from the source.</exception>
1411 <exception cref="T:System.TimeoutException">The specified time-out expired before an item was received from the source.</exception>
1412 <exception cref="T:System.OperationCanceledException">The operation was canceled before an item was received from the source.</exception>
1414 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0})">
1415 <summary>Asynchronously receives a value from a specified source.</summary>
1416 <param name="source">The source from which to receive the value.</param>
1417 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1418 <returns>A task that represents the asynchronous receive operation. When an item value is successfully received from the source, the returned task is completed and its <see cref="System.Threading.Tasks.Task`1.Result"></see> returns the received value. If an item value cannot be retrieved because the source is empty and completed , an <see cref="System.InvalidOperationException"></see> exception is thrown in the returned task.</returns>
1419 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1421 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.Threading.CancellationToken)">
1422 <summary>Asynchronously receives a value from a specified source and provides a token to cancel the operation.</summary>
1423 <param name="source">The source from which to receive the value.</param>
1424 <param name="cancellationToken">The token to use to cancel the receive operation.</param>
1425 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1426 <returns>A task that represents the asynchronous receive operation. When a value is successfully received from the source, the returned task is completed and its <see cref="System.Threading.Tasks.Task`1.Result"></see> returns the value. If a value cannot be retrieved because cancellation was requested, the returned task is canceled. If the value cannot be retrieved because the source is empty and completed , an <see cref="System.InvalidOperationException"></see> exception is thrown in the returned task.</returns>
1427 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1429 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.TimeSpan)">
1430 <summary>Asynchronously receives a value from a specified source, observing an optional time-out period.</summary>
1431 <param name="source">The source from which to receive the value.</param>
1432 <param name="timeout">The maximum time interval, in milliseconds, to wait for the synchronous operation to complete, or an interval that represents -1 milliseconds to wait indefinitely.</param>
1433 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1434 <returns>A task that represents the asynchronous receive operation. When a value is successfully received from the source, the returned task is completed and its <see cref="System.Threading.Tasks.Task`1.Result"></see> returns the value. If a value cannot be retrieved because the time-out expired, the returned task is canceled. If the value cannot be retrieved because the source is empty and completed , an <see cref="System.InvalidOperationException"></see> exception is thrown in the returned task.</returns>
1435 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1436 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="timeout">timeout</paramref> is a negative number other than -1 milliseconds, which represents an infinite time-out period.
1438 <paramref name="timeout">timeout</paramref> is greater than <see cref="System.Int32.MaxValue"></see>.</exception>
1440 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync``1(System.Threading.Tasks.Dataflow.ISourceBlock{``0},System.TimeSpan,System.Threading.CancellationToken)">
1441 <summary>Asynchronously receives a value from a specified source, providing a token to cancel the operation and observing an optional time-out interval.</summary>
1442 <param name="source">The source from which to receive the value.</param>
1443 <param name="timeout">The maximum time interval, in milliseconds, to wait for the synchronous operation to complete, or an interval that represents -1 milliseconds to wait indefinitely.</param>
1444 <param name="cancellationToken">The token which may be used to cancel the receive operation.</param>
1445 <typeparam name="TOutput">The type of data contained in the source.</typeparam>
1446 <returns>A task that represents the asynchronous receive operation. When a value is successfully received from the source, the returned task is completed and its <see cref="System.Threading.Tasks.Task`1.Result"></see> returns the value. If a value cannot be retrieved because the time-out expired or cancellation was requested, the returned task is canceled. If the value cannot be retrieved because the source is empty and completed, an <see cref="System.InvalidOperationException"></see> exception is thrown in the returned task.</returns>
1447 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
1448 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="timeout">timeout</paramref> is a negative number other than -1 milliseconds, which represents an infinite time-out period.
1450 <paramref name="timeout">timeout</paramref> is greater than <see cref="System.Int32.MaxValue"></see>.</exception>
1452 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync``1(System.Threading.Tasks.Dataflow.ITargetBlock{``0},``0,System.Threading.CancellationToken)">
1453 <summary>Asynchronously offers a message to the target message block, allowing for postponement.</summary>
1454 <param name="target">The target to which to post the data.</param>
1455 <param name="item">The item being offered to the target.</param>
1456 <param name="cancellationToken">The cancellation token with which to request cancellation of the send operation.</param>
1457 <typeparam name="TInput">Specifies the type of the data to post to the target.</typeparam>
1458 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that represents the asynchronous send. If the target accepts and consumes the offered element during the call to SendAsync, upon return from the call the resulting <see cref="System.Threading.Tasks.Task`1"></see> will be completed and its Result property will return true. If the target declines the offered element during the call, upon return from the call the resulting <see cref="System.Threading.Tasks.Task`1"></see> will be completed and its Result property will return false. If the target postpones the offered element, the element will be buffered until such time that the target consumes or releases it, at which point the Task will complete, with its Result indicating whether the message was consumed. If the target never attempts to consume or release the message, the returned task will never complete.
1459 If cancellation is requested before the target has successfully consumed the sent data, the returned task will complete in the Canceled state and the data will no longer be available to the target.</returns>
1460 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null (Nothing in Visual Basic).</exception>
1462 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync``1(System.Threading.Tasks.Dataflow.ITargetBlock{``0},``0)">
1463 <summary>Asynchronously offers a message to the target message block, allowing for postponement.</summary>
1464 <param name="target">The target to which to post the data.</param>
1465 <param name="item">The item being offered to the target.</param>
1466 <typeparam name="TInput">Specifies the type of the data to post to the target.</typeparam>
1467 <returns>A <see cref="System.Threading.Tasks.Task`1"></see> that represents the asynchronous send. If the target accepts and consumes the offered element during the call to <see cref="System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync``1(System.Threading.Tasks.Dataflow.ITargetBlock{``0},``0)"></see>, upon return from the call the resulting <see cref="System.Threading.Tasks.Task`1"></see> will be completed and its <see cref="System.Threading.Tasks.Task`1.Result"></see> property will return true. If the target declines the offered element during the call, upon return from the call the resulting <see cref="System.Threading.Tasks.Task`1"></see> will be completed and its <see cref="System.Threading.Tasks.Task`1.Result"></see> property will return false. If the target postpones the offered element, the element will be buffered until such time that the target consumes or releases it, at which point the task will complete, with its <see cref="System.Threading.Tasks.Task`1.Result"></see> indicating whether the message was consumed. If the target never attempts to consume or release the message, the returned task will never complete.</returns>
1468 <exception cref="T:System.ArgumentNullException">The <paramref name="target">target</paramref> is null.</exception>
1470 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlock.TryReceive``1(System.Threading.Tasks.Dataflow.IReceivableSourceBlock{``0},``0@)">
1471 <summary>Attempts to synchronously receive an item from the <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1"></see>.</summary>
1472 <param name="source">The source from which to receive.</param>
1473 <param name="item">The item received from the source.</param>
1474 <typeparam name="TOutput">Specifies the type of data contained in the source.</typeparam>
1475 <returns>true if an item could be received; otherwise, false.</returns>
1477 <member name="T:System.Threading.Tasks.Dataflow.DataflowBlockOptions">
1478 <summary>Provides options used to configure the processing performed by dataflow blocks.</summary>
1480 <member name="M:System.Threading.Tasks.Dataflow.DataflowBlockOptions.#ctor">
1481 <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.DataflowBlockOptions"></see>.</summary>
1483 <member name="P:System.Threading.Tasks.Dataflow.DataflowBlockOptions.BoundedCapacity">
1484 <summary>Gets or sets the maximum number of messages that may be buffered by the block.</summary>
1485 <returns>The maximum number of messages.</returns>
1487 <member name="P:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken">
1488 <summary>Gets or sets the <see cref="T:System.Threading.CancellationToken"></see> to monitor for cancellation requests.</summary>
1489 <returns>The token.</returns>
1491 <member name="P:System.Threading.Tasks.Dataflow.DataflowBlockOptions.EnsureOrdered">
1494 <member name="P:System.Threading.Tasks.Dataflow.DataflowBlockOptions.MaxMessagesPerTask">
1495 <summary>Gets or sets the maximum number of messages that may be processed per task.</summary>
1496 <returns>The maximum number of messages. The default is -1, which indicates an unlimited number of messages.</returns>
1498 <member name="P:System.Threading.Tasks.Dataflow.DataflowBlockOptions.NameFormat">
1499 <summary>Gets or sets the format string to use when a block is queried for its name.</summary>
1500 <returns>The format string to use when a block is queried for its name.</returns>
1502 <member name="P:System.Threading.Tasks.Dataflow.DataflowBlockOptions.TaskScheduler">
1503 <summary>Gets or sets the <see cref="T:System.Threading.Tasks.TaskScheduler"></see> to use for scheduling tasks.</summary>
1504 <returns>The task scheduler.</returns>
1506 <member name="F:System.Threading.Tasks.Dataflow.DataflowBlockOptions.Unbounded">
1507 <summary>A constant used to specify an unlimited quantity for <see cref="T:System.Threading.Tasks.Dataflow.DataflowBlockOptions"></see> members that provide an upper bound. This field is constant.</summary>