TaskExtensions.Unwrap メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Unwrap(Task<Task>) |
|
| Unwrap<TResult>(Task<Task<TResult>>) |
|
Unwrap(Task<Task>)
- Source:
- TaskExtensions.cs
- Source:
- TaskExtensions.cs
- Source:
- TaskExtensions.cs
Task<Task> (C#) または Task (Of Task) (Visual Basic) の非同期操作を表すプロキシ Task を作成します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task ^ Unwrap(System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ task);public static System.Threading.Tasks.Task Unwrap (this System.Threading.Tasks.Task<System.Threading.Tasks.Task> task);static member Unwrap : System.Threading.Tasks.Task<System.Threading.Tasks.Task> -> System.Threading.Tasks.Task<Extension()>
Public Function Unwrap (task As Task(Of Task)) As Taskパラメーター
戻り値
指定された System.Threading.Tasks.Task(Of Task) の非同期操作を表すタスク。
例外
task 引数が null の場合にスローされる例外。
例
次の例は、タスクのラップを解除する方法を示しています。
using System;
using System.Diagnostics;
using System.Threading;
using System.Threading.Tasks;
class UnWrapDemo
{
// Demonstrated features:
// Task.Unwrap()
// Task.Factory.StartNew()
// Task.ContinueWith()
// Expected results:
// Indicates that continuation chains can be set up virtually instantaneously using Unwrap(), and then left to run on their own.
// The results of the RemoteIncrement(0) chain and the RemoteIncrement(4) chain may be intermixed with each other.
// The results of the sequence that starts with RemoteIncrement(4) are in strict order.
// Documentation:
// http://msdn.microsoft.com/library/dd781129(VS.100).aspx
// More information:
// http://blogs.msdn.com/pfxteam/archive/2009/11/04/9917581.aspx
// Other notes:
// The combination of Task<T>, ContinueWith() and Unwrap() can be particularly useful for setting up a chain of long-running
// tasks where each task uses the results of its predecessor.
static void Main()
{
// Invoking individual tasks is straightforward
Task<int> t1 = RemoteIncrement(0);
Console.WriteLine("Started RemoteIncrement(0)");
// Chain together the results of (simulated) remote operations.
// The use of Unwrap() instead of .Result below prevents this thread from blocking while setting up this continuation chain.
Task<int> t2 = RemoteIncrement(4)
.ContinueWith(t => RemoteIncrement(t.Result)) // RemoteIncrement() returns Task<int> so no unwrapping is needed for the first continuation.
.Unwrap().ContinueWith(t => RemoteIncrement(t.Result)) // ContinueWith() returns Task<Task<int>>. Therefore unwrapping is needed.
.Unwrap().ContinueWith(t => RemoteIncrement(t.Result)) // and on it goes...
.Unwrap();
Console.WriteLine("Started RemoteIncrement(...(RemoteIncrement(RemoteIncrement(4))...)");
try
{
t1.Wait();
Console.WriteLine("Finished RemoteIncrement(0)\n");
t2.Wait();
Console.WriteLine("Finished RemoteIncrement(...(RemoteIncrement(RemoteIncrement(4))...)");
}
catch (AggregateException e)
{
Console.WriteLine("A task has thrown the following (unexpected) exception:\n{0}", e);
}
}
// This method represents a remote API.
static Task<int> RemoteIncrement(int n)
{
return Task<int>.Factory.StartNew(
(obj) =>
{
// Simulate a slow operation
Thread.Sleep(1 * 1000);
int x = (int)obj;
Console.WriteLine("Thread={0}, Next={1}", Thread.CurrentThread.ManagedThreadId, ++x);
return x;
},
n);
}
}
Imports System.Threading
Imports System.Threading.Tasks
Module UnwrapDemo
' Demonstrated features:
' Task.Unwrap()
' Task.Factory.StartNew()
' Task.ContinueWith()
' Expected results:
' Indicates that continuation chains can be set up virtually instantaneously using Unwrap(), and then left to run on their own.
' The results of the RemoteIncrement(0) chain and the RemoteIncrement(4) chain may be intermixed with each other.
' The results of the sequence that starts with RemoteIncrement(4) are in strict order.
' Documentation:
' http://msdn.microsoft.com/library/dd781129(VS.100).aspx
' More information:
' http://blogs.msdn.com/pfxteam/archive/2009/11/04/9917581.aspx
' Other notes:
' The combination of Task<T>, ContinueWith() and Unwrap() can be particularly useful for setting up a chain of long-running
' tasks where each task uses the results of its predecessor.
Sub Main()
' Invoking individual tasks is straightforward
Dim t1 As Task(Of Integer) = RemoteIncrement(0)
Console.WriteLine("Started RemoteIncrement(0)")
' Chain together the results of (simulated) remote operations.
' The use of Unwrap() instead of .Result below prevents this thread from blocking while setting up this continuation chain.
' RemoteIncrement() returns Task<int> so no unwrapping is needed for the first continuation.
' ContinueWith() here returns Task<Task<int>>. Therefore unwrapping is needed.
' and on it goes...
Dim t2 As Task(Of Integer) = RemoteIncrement(4).ContinueWith(Function(t) RemoteIncrement(t.Result)).Unwrap().ContinueWith(Function(t) RemoteIncrement(t.Result)).Unwrap().ContinueWith(Function(t) RemoteIncrement(t.Result)).Unwrap()
Console.WriteLine("Started RemoteIncrement(...(RemoteIncrement(RemoteIncrement(4))...)")
Try
t1.Wait()
Console.WriteLine("Finished RemoteIncrement(0)" & vbLf)
t2.Wait()
Console.WriteLine("Finished RemoteIncrement(...(RemoteIncrement(RemoteIncrement(4))...)")
Catch e As AggregateException
Console.WriteLine("A task has thrown the following (unexpected) exception:" & vbLf & "{0}", e)
End Try
End Sub
' This method represents a remote API.
Function RemoteIncrement(ByVal n As Integer) As Task(Of Integer)
Return Task(Of Integer).Factory.StartNew(Function(obj)
' Simulate a slow operation
Thread.Sleep(1 * 1000)
Dim x As Integer = CInt(obj)
Console.WriteLine("Thread={0}, Next={1}", Thread.CurrentThread.ManagedThreadId, System.Threading.Interlocked.Increment(x))
Return x
End Function, n)
End Function
End Module
注釈
多くの場合、 から Task<TResult>Task を返すことができると便利です。この場合、内部 Task は外側 Task<TResult>の の一部として実行された作業を表します。 ただし、これを行うと、(C#) または Task (Of Task) (Visual Basic) が発生Task<Task>します。慎重に処理しないと、予期しない動作が発生する可能性があります。 アンラップでは、このようなタスクの非同期操作全体を表すプロキシ タスクを作成することで、この問題を解決します。
こちらもご覧ください
適用対象
Unwrap<TResult>(Task<Task<TResult>>)
- Source:
- TaskExtensions.cs
- Source:
- TaskExtensions.cs
- Source:
- TaskExtensions.cs
Task<Task<T>> (C#) または Task (Of Task(Of T)) (Visual Basic) の非同期操作を表すプロキシ Task を作成します。
public:
generic <typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<TResult> ^ Unwrap(System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ task);public static System.Threading.Tasks.Task<TResult> Unwrap<TResult> (this System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> task);static member Unwrap : System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task<'Result><Extension()>
Public Function Unwrap(Of TResult) (task As Task(Of Task(Of TResult))) As Task(Of TResult)型パラメーター
- TResult
タスクの結果の型。
パラメーター
戻り値
指定された Task<Task<T>> (C#) または Task (Of Task(Of T)) (Visual Basic) の非同期操作を表す Task。
例外
task 引数が null の場合にスローされる例外。
注釈
多くの場合、 から を返Taskすことができると便利です。内部Taskは外側Taskの の一部として実行される作業を表Taskします。 ただし、これを行うと、(C#) または Task (Of Task(Of T)) (Visual Basic) が発生Task<Task<T>>します。慎重に処理しないと、予期しない動作が発生する可能性があります。 アンラップでは、このような (C#) または Task (Of Task(Of T)) (Visual Basic) の非同期操作全体を表すプロキシTask<TResult>をTask<Task<T>>作成することで、この問題を解決します。
こちらもご覧ください
適用対象
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示