DataflowBlock.Choose メソッド

定義

名前空間:

System.Threading.Tasks.Dataflow

アセンブリ:

System.Threading.Tasks.Dataflow.dll

オーバーロード

Choose<T1,T2,T3>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>, ISourceBlock<T3>, Action<T3>)	3 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。
Choose<T1,T2,T3>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>, ISourceBlock<T3>, Action<T3>, DataflowBlockOptions)	3 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。
Choose<T1,T2>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>)	2 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。
Choose<T1,T2>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>, DataflowBlockOptions)	2 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。

Choose<T1,T2,T3>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>, ISourceBlock<T3>, Action<T3>)

ソース:

DataflowBlock.cs

3 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。

public:
generic <typename T1, typename T2, typename T3>
 static System::Threading::Tasks::Task<int> ^ Choose(System::Threading::Tasks::Dataflow::ISourceBlock<T1> ^ source1, Action<T1> ^ action1, System::Threading::Tasks::Dataflow::ISourceBlock<T2> ^ source2, Action<T2> ^ action2, System::Threading::Tasks::Dataflow::ISourceBlock<T3> ^ source3, Action<T3> ^ action3);

public static System.Threading.Tasks.Task<int> Choose<T1,T2,T3> (System.Threading.Tasks.Dataflow.ISourceBlock<T1> source1, Action<T1> action1, System.Threading.Tasks.Dataflow.ISourceBlock<T2> source2, Action<T2> action2, System.Threading.Tasks.Dataflow.ISourceBlock<T3> source3, Action<T3> action3);

static member Choose : System.Threading.Tasks.Dataflow.ISourceBlock<'T1> * Action<'T1> * System.Threading.Tasks.Dataflow.ISourceBlock<'T2> * Action<'T2> * System.Threading.Tasks.Dataflow.ISourceBlock<'T3> * Action<'T3> -> System.Threading.Tasks.Task<int>

Public Function Choose(Of T1, T2, T3) (source1 As ISourceBlock(Of T1), action1 As Action(Of T1), source2 As ISourceBlock(Of T2), action2 As Action(Of T2), source3 As ISourceBlock(Of T3), action3 As Action(Of T3)) As Task(Of Integer)

型パラメーター

T1

最初のソースに格納されるデータの種類を指定します。

T2

2 番目のソースに格納されるデータの種類を指定します。

T3

3 番目のソースに格納されるデータの種類を指定します。

パラメーター

source1

ISourceBlock<T1>

1 番目のソース。

action1

Action<T1>

最初のソースからのデータで実行するハンドラー。

source2

ISourceBlock<T2>

2 番目のソース。

action2

Action<T2>

2 番目のソースからのデータで実行するハンドラー。

source3

ISourceBlock<T3>

3 番目のソース。

action3

Action<T3>

3 番目のソースのデータで実行するハンドラー。

戻り値

Task<Int32>

Task<TResult>非同期選択を表す 。 すべてのソースが選択の完了前に完了すると、結果のタスクは取り消されます。 いずれかのソースに使用できるデータがあり、それを選択内容に正常に反映した場合、ハンドラーの完了時に結果のタスクが完了します。ハンドラーが例外をスローした場合、タスクは Faulted 状態で終了し、未処理の例外が含まれます。 それ以外の場合、タスクは Result がソースの 0 から始まるインデックスに設定された状態で終了します。

このメソッドは、1 つのデータ ソースからのみ要素を使用します。複数のデータ ソースから要素を使用することはありません。

例外

ArgumentNullException

source1 が null です。

- または -

action1 が null です。

- または -

source2 が null です。

- または -

action2 が null です。

- または -

source3 が null です。

- または -

action3 が null です。

Choose<T1,T2,T3>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>, ISourceBlock<T3>, Action<T3>, DataflowBlockOptions)

ソース:

DataflowBlock.cs

3 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。

public:
generic <typename T1, typename T2, typename T3>
 static System::Threading::Tasks::Task<int> ^ Choose(System::Threading::Tasks::Dataflow::ISourceBlock<T1> ^ source1, Action<T1> ^ action1, System::Threading::Tasks::Dataflow::ISourceBlock<T2> ^ source2, Action<T2> ^ action2, System::Threading::Tasks::Dataflow::ISourceBlock<T3> ^ source3, Action<T3> ^ action3, System::Threading::Tasks::Dataflow::DataflowBlockOptions ^ dataflowBlockOptions);

public static System.Threading.Tasks.Task<int> Choose<T1,T2,T3> (System.Threading.Tasks.Dataflow.ISourceBlock<T1> source1, Action<T1> action1, System.Threading.Tasks.Dataflow.ISourceBlock<T2> source2, Action<T2> action2, System.Threading.Tasks.Dataflow.ISourceBlock<T3> source3, Action<T3> action3, System.Threading.Tasks.Dataflow.DataflowBlockOptions dataflowBlockOptions);

static member Choose : System.Threading.Tasks.Dataflow.ISourceBlock<'T1> * Action<'T1> * System.Threading.Tasks.Dataflow.ISourceBlock<'T2> * Action<'T2> * System.Threading.Tasks.Dataflow.ISourceBlock<'T3> * Action<'T3> * System.Threading.Tasks.Dataflow.DataflowBlockOptions -> System.Threading.Tasks.Task<int>

Public Function Choose(Of T1, T2, T3) (source1 As ISourceBlock(Of T1), action1 As Action(Of T1), source2 As ISourceBlock(Of T2), action2 As Action(Of T2), source3 As ISourceBlock(Of T3), action3 As Action(Of T3), dataflowBlockOptions As DataflowBlockOptions) As Task(Of Integer)

型パラメーター

T1

最初のソースに格納されるデータの種類を指定します。

T2

2 番目のソースに格納されるデータの種類を指定します。

T3

3 番目のソースに格納されるデータの種類を指定します。

パラメーター

source1

ISourceBlock<T1>

1 番目のソース。

action1

Action<T1>

最初のソースからのデータで実行するハンドラー。

source2

ISourceBlock<T2>

2 番目のソース。

action2

Action<T2>

2 番目のソースからのデータで実行するハンドラー。

source3

ISourceBlock<T3>

3 番目のソース。

action3

Action<T3>

3 番目のソースのデータで実行するハンドラー。

dataflowBlockOptions

DataflowBlockOptions

この選択の構成に使用するオプション。

戻り値

Task<Int32>

Task<TResult>非同期選択を表す 。 すべてのソースが選択の完了前に完了するか、dataflowBlockOptions の一部として提供された CancellationToken が選択の完了前に取り消される場合、結果のタスクは取り消されます。 いずれかのソースに使用できるデータがあり、それを選択内容に正常に反映した場合、ハンドラーの完了時に結果のタスクが完了します。ハンドラーが例外をスローした場合、タスクは Faulted 状態で終了し、未処理の例外が含まれます。 それ以外の場合、タスクは Result がソースの 0 から始まるインデックスに設定された状態で終了します。

このメソッドは、1 つのデータ ソースからのみ要素を使用します。複数のデータ ソースから要素を使用することはありません。 要素が受信された後で取り消しが要求された場合、取り消し要求は無視され、関連するハンドラーの実行が許可されます。

例外

ArgumentNullException

source1 が null です。

- または -

action1 が null です。

- または -

source2 が null です。

- または -

action2 が null です。

- または -

source3 が null です。

- または -

action3 が null です。

- または -

dataflowBlockOptions が null です。

Choose<T1,T2>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>)

ソース:

DataflowBlock.cs

2 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。

public:
generic <typename T1, typename T2>
 static System::Threading::Tasks::Task<int> ^ Choose(System::Threading::Tasks::Dataflow::ISourceBlock<T1> ^ source1, Action<T1> ^ action1, System::Threading::Tasks::Dataflow::ISourceBlock<T2> ^ source2, Action<T2> ^ action2);

public static System.Threading.Tasks.Task<int> Choose<T1,T2> (System.Threading.Tasks.Dataflow.ISourceBlock<T1> source1, Action<T1> action1, System.Threading.Tasks.Dataflow.ISourceBlock<T2> source2, Action<T2> action2);

static member Choose : System.Threading.Tasks.Dataflow.ISourceBlock<'T1> * Action<'T1> * System.Threading.Tasks.Dataflow.ISourceBlock<'T2> * Action<'T2> -> System.Threading.Tasks.Task<int>

Public Function Choose(Of T1, T2) (source1 As ISourceBlock(Of T1), action1 As Action(Of T1), source2 As ISourceBlock(Of T2), action2 As Action(Of T2)) As Task(Of Integer)

型パラメーター

T1

最初のソースに格納されるデータの種類を指定します。

T2

2 番目のソースに格納されるデータの種類を指定します。

パラメーター

source1

ISourceBlock<T1>

1 番目のソース。

action1

Action<T1>

最初のソースからのデータで実行するハンドラー。

source2

ISourceBlock<T2>

2 番目のソース。

action2

Action<T2>

2 番目のソースからのデータで実行するハンドラー。

戻り値

Task<Int32>

Task<TResult>非同期選択を表す 。 両方のソースが選択の完了前に完了すると、結果のタスクは取り消されます。 いずれかのソースに使用できるデータがあり、それを選択内容に正常に反映した場合、ハンドラーの完了時に結果のタスクが完了します。ハンドラーが例外をスローした場合、タスクは Faulted 状態で終了し、未処理の例外が含まれます。 それ以外の場合、タスクは最初または 2 つ目のソースを表すためにそれぞれ Result が 0 または 1 に設定された状態で終了します。

このメソッドは、2 つのデータ ソースのいずれかからのみ要素を使用します。両方のデータ ソースから要素を使用することはありません。

例外

ArgumentNullException

source1 が null です。

- または -

action1 が null です。

- または -

source2 が null です。

- または -

action2 が null です。

Choose<T1,T2>(ISourceBlock<T1>, Action<T1>, ISourceBlock<T2>, Action<T2>, DataflowBlockOptions)

ソース:

DataflowBlock.cs

2 つのデータ フロー ソースを監視し、データが最初に使用できるようになったソースに対して、指定したハンドラーを呼び出します。

public:
generic <typename T1, typename T2>
 static System::Threading::Tasks::Task<int> ^ Choose(System::Threading::Tasks::Dataflow::ISourceBlock<T1> ^ source1, Action<T1> ^ action1, System::Threading::Tasks::Dataflow::ISourceBlock<T2> ^ source2, Action<T2> ^ action2, System::Threading::Tasks::Dataflow::DataflowBlockOptions ^ dataflowBlockOptions);

public static System.Threading.Tasks.Task<int> Choose<T1,T2> (System.Threading.Tasks.Dataflow.ISourceBlock<T1> source1, Action<T1> action1, System.Threading.Tasks.Dataflow.ISourceBlock<T2> source2, Action<T2> action2, System.Threading.Tasks.Dataflow.DataflowBlockOptions dataflowBlockOptions);

static member Choose : System.Threading.Tasks.Dataflow.ISourceBlock<'T1> * Action<'T1> * System.Threading.Tasks.Dataflow.ISourceBlock<'T2> * Action<'T2> * System.Threading.Tasks.Dataflow.DataflowBlockOptions -> System.Threading.Tasks.Task<int>

Public Function Choose(Of T1, T2) (source1 As ISourceBlock(Of T1), action1 As Action(Of T1), source2 As ISourceBlock(Of T2), action2 As Action(Of T2), dataflowBlockOptions As DataflowBlockOptions) As Task(Of Integer)

型パラメーター

T1

最初のソースに格納されるデータの種類を指定します。

T2

2 番目のソースに格納されるデータの種類を指定します。

パラメーター

source1

ISourceBlock<T1>

1 番目のソース。

action1

Action<T1>

最初のソースからのデータで実行するハンドラー。

source2

ISourceBlock<T2>

2 番目のソース。

action2

Action<T2>

2 番目のソースからのデータで実行するハンドラー。

dataflowBlockOptions

DataflowBlockOptions

この選択の構成に使用するオプション。

戻り値

Task<Int32>

Task<TResult>非同期選択を表す 。 両方のソースが選択の完了前に完了するか、dataflowBlockOptions の一部として提供された CancellationToken が選択の完了前に取り消される場合、結果のタスクは取り消されます。 いずれかのソースに使用できるデータがあり、それを選択内容に正常に反映した場合、ハンドラーの完了時に結果のタスクが完了します。ハンドラーが例外をスローした場合、タスクは Faulted 状態で終了し、未処理の例外が含まれます。 それ以外の場合、タスクは最初または 2 つ目のソースを表すためにそれぞれ Result が 0 または 1 に設定された状態で終了します。

例外

ArgumentNullException

source1 が null です。

- または -

action1 が null です。

- または -

source2 が null です。

- または -

action2 が null です。

- または -

dataflowBlockOptions が null です。