TaskFactory.StartNew メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスクを作成して開始します。
オーバーロード
注釈
.NET Framework 4.5 以降では、Task.Runコンピューティング バインド タスクを起動する方法をお勧めします。 このメソッドは、実行時間の StartNew 長いコンピューティング バインド タスクに対してきめ細かい制御が必要な場合にのみ使用します。 これには、以下を制御するシナリオが含まれます。
タスクの作成オプション。 既定では、 Task.Run メソッドによって作成されたタスクは、オプションを使用して TaskCreationOptions.DenyChildAttach 作成されます。 この動作をオーバーライドしたり、他 TaskCreationOptions のオプションを指定したりするには、オーバーロードを StartNew 呼び出します。
パラメーターの受け渡し。 メソッドの Task.Run オーバーロードでは、パラメーターをタスク デリゲートに渡すことができません。 メソッドのオーバーロードは StartNew 行います。
タスク スケジューラ。 メソッドのオーバーロードでは、 Task.Run 既定のタスク スケジューラが使用されます。 タスク スケジューラを制御するには、パラメーターを使用して StartNew オーバーロードを
scheduler呼び出します。 詳細については、「TaskScheduler」を参照してください。
StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)
指定されたアクション デリゲート、状態、取り消しトークン、作成オプション、およびタスク スケジューラーのタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);member this.StartNew : Action<obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Taskパラメーター
- state
- Object
action デリゲートによって使用されるデータを格納しているオブジェクト。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
- scheduler
- TaskScheduler
作成されたタスクをスケジュールするときに使用するタスク スケジューラー。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
creationOptions 引数に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。
注釈
StartNew の呼び出しは、機能的には、いずれかのコンストラクターを使用してタスクを作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET を使用した並列プログラミング」ブログの 「Task.Run と Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)
指定されたアクション デリゲート、取り消しトーク、作成オプション、および状態のタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);public System.Threading.Tasks.Task StartNew (Action action, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);member this.StartNew : Action * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Taskパラメーター
- action
- Action
非同期で実行するアクション デリゲート。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
- scheduler
- TaskScheduler
作成されたタスクをスケジュールするときに使用するタスク スケジューラー。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。
注釈
StartNew の呼び出しは、機能的には、いずれかのコンストラクターを使用してタスクを作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET を使用した並列プログラミング」ブログの 「Task.Run と Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action<Object>, Object, TaskCreationOptions)
指定されたアクション デリゲート、状態、および作成オプションのタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);member this.StartNew : Action<obj> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action(Of Object), state As Object, creationOptions As TaskCreationOptions) As Taskパラメーター
- state
- Object
action デリゲートによって使用されるデータを格納しているオブジェクト。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
戻り値
開始されたタスク。
例外
action が nullです。
creationOptions に無効な TaskCreationOptions 値が指定されています。
注釈
StartNew の呼び出しは、機能的には、いずれかのコンストラクターを使用してタスクを作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET を使用した並列プログラミング」ブログの 「Task.Run と Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action<Object>, Object, CancellationToken)
指定されたアクション デリゲート、状態、および取り消しトークンのタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.CancellationToken cancellationToken);public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken);member this.StartNew : Action<obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken) As Taskパラメーター
- state
- Object
action デリゲートによって使用されるデータを格納しているオブジェクト。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
action が nullです。
例
次の例では、6 文字の単語の配列を定義します。 その後、各単語がデリゲートに Action<T> 渡され、単語がスクランブルされ、元の単語とそのスクランブル バージョンが表示されます。
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
CancellationTokenSource cts = new CancellationTokenSource();
CancellationToken token = cts.Token;
var tasks = new List<Task>();
Random rnd = new Random();
Object lockObj = new Object();
String[] words6 = { "reason", "editor", "rioter", "rental",
"senior", "regain", "ordain", "rained" };
foreach (var word6 in words6)
tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
double[] order = new double[chars.Length];
token.ThrowIfCancellationRequested();
bool wasZero = false;
lock (lockObj) {
for (int ctr = 0; ctr < order.Length; ctr++) {
order[ctr] = rnd.NextDouble();
if (order[ctr] == 0) {
if (! wasZero) {
wasZero = true;
}
else {
cts.Cancel();
}
}
}
}
token.ThrowIfCancellationRequested();
Array.Sort(order, chars);
Console.WriteLine("{0} --> {1}", word,
new String(chars));
}, word6, token));
try {
Task.WaitAll(tasks.ToArray());
}
catch (AggregateException e) {
foreach (var ie in e.InnerExceptions) {
if (ie is OperationCanceledException) {
Console.WriteLine("The word scrambling operation has been cancelled.");
break;
}
else {
Console.WriteLine(ie.GetType().Name + ": " + ie.Message);
}
}
}
finally {
cts.Dispose();
}
}
}
// The example displays output like the following:
// regain --> irnaeg
// ordain --> rioadn
// reason --> soearn
// rained --> rinade
// rioter --> itrore
// senior --> norise
// rental --> atnerl
// editor --> oteird
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim cts As New CancellationTokenSource()
Dim token As CancellationToken = cts.Token
Dim tasks As New List(Of Task)()
Dim rnd As New Random()
Dim lockObj As New Object()
Dim words6() As String = { "reason", "editor", "rioter", "rental",
"senior", "regain", "ordain", "rained" }
For Each word6 in words6
tasks.Add(Task.Factory.StartNew( Sub(word)
Dim chars() As Char = word.ToString().ToCharArray()
Dim order(chars.Length - 1) As Double
Dim wasZero As Boolean = False
SyncLock lockObj
For ctr As Integer = 0 To order.Length - 1
order(ctr) = rnd.NextDouble()
If order(ctr) = 0 Then
If Not wasZero Then
wasZero = True
Else
cts.Cancel()
End If
End If
Next
End SyncLock
token.ThrowIfCancellationRequested()
Array.Sort(order, chars)
Console.WriteLine("{0} --> {1}", word,
new String(chars))
End Sub, word6))
Next
Try
Task.WaitAll(tasks.ToArray())
Catch e As AggregateException
For Each ie In e.InnerExceptions
If TypeOf ie Is OperationCanceledException
Console.WriteLine("The word scrambling operation has been cancelled.")
Exit For
Else
Console.WriteLine(ie.GetType().Name + ": " + ie.Message)
End If
Next
Finally
cts.Dispose()
End Try
End Sub
End Module
' The example displays output like the following:
' regain --> irnaeg
' ordain --> rioadn
' reason --> soearn
' rained --> rinade
' rioter --> itrore
' senior --> norise
' rental --> atnerl
' editor --> oteird
この例では、ロックによって保護される 1 つの乱数ジェネレーターを初期化します。 ロックの必要性については、クラストピックの「System.Random クラスとスレッドセーフ」を Random 参照してください。 乱数ジェネレーターの破損の可能性を処理するために、キャンセル トークンがタスクに渡されます。 2 つの乱数が 0 に等しい場合、このメソッドは乱数ジェネレーターが破損していることを前提とし、キャンセル トークンを設定します。 単語内の chars 6 文字を含む配列を並べ替える前に、トークンが取り消された場合にメソッドをOperationCanceledException呼び出CancellationToken.ThrowIfCancellationRequestedしてスローします。
注釈
StartNew の呼び出しは、機能的には、いずれかのコンストラクターを使用してタスクを作成し、実行のスケジュールを設定する呼び出 Start しと同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET を使用した並列プログラミング」ブログの 「Task.Run と Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action, CancellationToken)
指定されたアクション デリゲートおよび取り消しトークンのタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task StartNew (Action action, System.Threading.CancellationToken cancellationToken);member this.StartNew : Action * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action, cancellationToken As CancellationToken) As Taskパラメーター
- action
- Action
非同期で実行するアクション デリゲート。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
action が nullです。
例
次の例では、メソッドをStartNew(Action, CancellationToken)呼び出して、C:\Windows\System32 ディレクトリ内のファイルを反復処理するタスクを作成します。 ラムダ式はメソッドを Parallel.ForEach 呼び出して、各ファイルに関する情報をオブジェクトに List<T> 追加します。 ループによって Parallel.ForEach 呼び出されるデタッチされた入れ子になった各タスクは、キャンセル トークンの状態をチェックし、取り消しが要求された場合はメソッドを CancellationToken.ThrowIfCancellationRequested 呼び出します。 メソッドはCancellationToken.ThrowIfCancellationRequested、呼び出し元のスレッドがメソッドをOperationCanceledExceptioncatch呼び出すときにブロック内で処理される例外をTask.Waitスローします。
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
var tokenSource = new CancellationTokenSource();
var token = tokenSource.Token;
var files = new List<Tuple<string, string, long, DateTime>>();
var t = Task.Factory.StartNew( () => { string dir = "C:\\Windows\\System32\\";
object obj = new Object();
if (Directory.Exists(dir)) {
Parallel.ForEach(Directory.GetFiles(dir),
f => {
if (token.IsCancellationRequested)
token.ThrowIfCancellationRequested();
var fi = new FileInfo(f);
lock(obj) {
files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc));
}
});
}
}
, token);
tokenSource.Cancel();
try {
t.Wait();
Console.WriteLine("Retrieved information for {0} files.", files.Count);
}
catch (AggregateException e) {
Console.WriteLine("Exception messages:");
foreach (var ie in e.InnerExceptions)
Console.WriteLine(" {0}: {1}", ie.GetType().Name, ie.Message);
Console.WriteLine("\nTask status: {0}", t.Status);
}
finally {
tokenSource.Dispose();
}
}
}
// The example displays the following output:
// Exception messages:
// TaskCanceledException: A task was canceled.
//
// Task status: Canceled
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim tokenSource As New CancellationTokenSource()
Dim token As CancellationToken = tokenSource.Token
Dim files As New List(Of Tuple(Of String, String, Long, Date))()
Dim t As Task = Task.Factory.StartNew( Sub()
Dim dir As String = "C:\Windows\System32\"
Dim obj As New Object()
If Directory.Exists(dir)Then
Parallel.ForEach(Directory.GetFiles(dir),
Sub(f)
If token.IsCancellationRequested Then
token.ThrowIfCancellationRequested()
End If
Dim fi As New FileInfo(f)
SyncLock(obj)
files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc))
End SyncLock
End Sub)
End If
End Sub, token)
tokenSource.Cancel()
Try
t.Wait()
Console.WriteLine("Retrieved information for {0} files.", files.Count)
Catch e As AggregateException
Console.WriteLine("Exception messages:")
For Each ie As Exception In e.InnerExceptions
Console.WriteLine(" {0}:{1}", ie.GetType().Name, ie.Message)
Next
Console.WriteLine()
Console.WriteLine("Task status: {0}", t.Status)
Finally
tokenSource.Dispose()
End Try
End Sub
End Module
' The example displays the following output:
' Exception messages:
' TaskCanceledException: A task was canceled.
'
' Task status: Canceled
注釈
呼び出し StartNew は機能的には、いずれかのコンストラクターを使用して Task を作成し、実行のスケジュールを設定する呼び出 Start しと同じです。
.NET Framework 4.5 以降では、既定のパラメーターをTask.Run(Action, CancellationToken)使用して呼び出すStartNew(Action, CancellationToken)簡単な方法としてメソッドを使用できます。 ただし、2 つのメソッドTask.Run(Action, CancellationToken)の動作には違いがあることに注意してください。既定では、現在TaskのインスタンスにアタッチするオプションでTaskCreationOptions.AttachedToParent開始された子タスクはStartNew(Action, CancellationToken)許可されません。 詳細とコード例については、「.NET での並列プログラミング」ブログの 「Task.Run vs Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action, TaskCreationOptions)
指定されたアクション デリゲートおよび作成オプションのタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::Tasks::TaskCreationOptions creationOptions);public System.Threading.Tasks.Task StartNew (Action action, System.Threading.Tasks.TaskCreationOptions creationOptions);member this.StartNew : Action * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action, creationOptions As TaskCreationOptions) As Taskパラメーター
- action
- Action
非同期で実行するアクション デリゲート。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
戻り値
開始されたタスク。
例外
action が nullです。
creationOptions に無効な TaskCreationOptions 値が指定されています。
注釈
StartNew の呼び出しは、機能的には、いずれかのコンストラクターを使用してタスクを作成し、実行のスケジュールを設定する呼び出 Start しと同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単なAction方法として、オブジェクトでメソッドを使用できます。 詳細とコード例については、「.NET での並列プログラミング」ブログの 「Task.Run vs Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action)
指定されたアクション デリゲートのタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action ^ action);public System.Threading.Tasks.Task StartNew (Action action);member this.StartNew : Action -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action) As Taskパラメーター
- action
- Action
非同期で実行するアクション デリゲート。
戻り値
開始されたタスク。
例外
action 引数が null です。
例
次の例では、このメソッドを StartNew(Action) 使用して、乱数を生成し、Unicode コード ポイントとして解釈し、UTF16 でエンコードされたコード単位に変換し、結果の文字または文字に関する情報を表示するデリゲートを繰り返し呼び出 Action します。
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
Random rnd = new Random();
List<Task> tasks = new List<Task>();
// Execute the task 10 times.
for (int ctr = 1; ctr <= 9; ctr++) {
tasks.Add(Task.Factory.StartNew( () => {
int utf32 = 0;
lock(rnd) {
// Get UTF32 value.
utf32 = rnd.Next(0, 0xE01F0);
}
// Convert it to a UTF16-encoded character.
string utf16 = Char.ConvertFromUtf32(utf32);
// Display information about the character.
Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})",
utf32, utf16, ShowHex(utf16));
}));
}
Task.WaitAll(tasks.ToArray());
}
private static string ShowHex(string value)
{
string hexString = null;
// Handle only non-control characters.
if (! Char.IsControl(value, 0)) {
foreach (var ch in value)
hexString += $"0x{(ushort)ch:X} ";
}
return hexString.Trim();
}
}
// The example displays the following output:
// 0x00097103 --> '' (0x55836 0x56579)
// 0x000A98A1 --> '' (0x55910 0x56481)
// 0x00050002 --> '' (0x55552 0x56322)
// 0x0000FEF1 --> 'ﻱ' (0x65265)
// 0x0008BC0A --> '' (0x55791 0x56330)
// 0x000860EA --> '' (0x55768 0x56554)
// 0x0009AC5A --> '' (0x55851 0x56410)
// 0x00053320 --> '' (0x55564 0x57120)
// 0x000874EF --> '' (0x55773 0x56559)
Imports System.Collections.Generic
Imports System.Threading.Tasks
Public Module Example
Public Sub Main()
Dim rnd As New Random()
Dim tasks As New List(Of Task)
' Execute the task 10 times.
For ctr As Integer = 1 To 9
tasks.Add(Task.Factory.StartNew(Sub()
Dim utf32 As Integer
SyncLock(rnd)
' Get UTF32 value.
utf32 = rnd.Next(0, &hE01F0)
End SyncLock
' Convert it to a UTF16-encoded character.
Dim utf16 As String = Char.ConvertFromUtf32(utf32)
' Display information about the character.
Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})",
utf32, utf16, ShowHex(utf16))
End Sub))
Next
Task.WaitAll(tasks.ToArray())
End Sub
Private Function ShowHex(value As String) As String
Dim hexString As String = Nothing
' Handle only non-control characters.
If Not Char.IsControl(value, 0) Then
For Each ch In value
hexString += String.Format("0x{0} ", Convert.ToUInt16(ch))
Next
End If
Return hexString.Trim()
End Function
End Module
' The example displays output similar to the following:
' 0x00097103 --> '' (0x55836 0x56579)
' 0x000A98A1 --> '' (0x55910 0x56481)
' 0x00050002 --> '' (0x55552 0x56322)
' 0x0000FEF1 --> 'ﻱ' (0x65265)
' 0x0008BC0A --> '' (0x55791 0x56330)
' 0x000860EA --> '' (0x55768 0x56554)
' 0x0009AC5A --> '' (0x55851 0x56410)
' 0x00053320 --> '' (0x55564 0x57120)
' 0x000874EF --> '' (0x55773 0x56559)
注釈
呼び出し StartNew は機能的には、いずれかのコンストラクターを使用してタスクを作成し、メソッドを Task.Start 呼び出してタスクの実行をスケジュールすることと同じです。
.NET Framework 4.5 以降では、既定のパラメーターをTask.Run(Action)使用して呼び出すStartNew(Action)簡単な方法としてメソッドを使用できます。 ただし、2 つのメソッドTask.Run(Action)の動作には違いがあることに注意してください。既定では、現在TaskのインスタンスにアタッチするオプションでTaskCreationOptions.AttachedToParent開始された子タスクはStartNew(Action)許可されません。 詳細とコード例については、「.NET での並列プログラミング」ブログの 「Task.Run vs Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew(Action<Object>, Object)
指定されたアクション デリゲートおよび状態のタスクを作成して開始します。
public:
System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state);public System.Threading.Tasks.Task StartNew (Action<object> action, object state);public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state);member this.StartNew : Action<obj> * obj -> System.Threading.Tasks.TaskPublic Function StartNew (action As Action(Of Object), state As Object) As Taskパラメーター
- state
- Object
action デリゲートによって使用されるデータを格納しているオブジェクト。
戻り値
開始されたタスク。
例外
action 引数が null です。
例
次の例では、6 文字の単語の配列を定義します。 その後、各単語がデリゲートに Action<T> 渡され、単語がスクランブルされ、元の単語とそのスクランブル されたバージョンが表示されます。
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
var tasks = new List<Task>();
Random rnd = new Random();
Object lockObj = new Object();
String[] words6 = { "reason", "editor", "rioter", "rental",
"senior", "regain", "ordain", "rained" };
foreach (var word6 in words6)
tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
double[] order = new double[chars.Length];
lock (lockObj) {
for (int ctr = 0; ctr < order.Length; ctr++)
order[ctr] = rnd.NextDouble();
}
Array.Sort(order, chars);
Console.WriteLine("{0} --> {1}", word,
new String(chars));
}, word6));
Task.WaitAll(tasks.ToArray());
}
}
// The example displays output like the following:
// regain --> irnaeg
// ordain --> rioadn
// reason --> soearn
// rained --> rinade
// rioter --> itrore
// senior --> norise
// rental --> atnerl
// editor --> oteird
Imports System.Collections.Generic
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim tasks As New List(Of Task)()
Dim rnd As New Random()
Dim lockObj As New Object()
Dim words6() As String = { "reason", "editor", "rioter", "rental",
"senior", "regain", "ordain", "rained" }
For Each word6 in words6
tasks.Add(Task.Factory.StartNew( Sub(word)
Dim chars() As Char = word.ToString().ToCharArray()
Dim order(chars.Length - 1) As Double
SyncLock lockObj
For ctr As Integer = 0 To order.Length - 1
order(ctr) = rnd.NextDouble()
Next
End SyncLock
Array.Sort(order, chars)
Console.WriteLine("{0} --> {1}", word,
new String(chars))
End Sub, word6))
Next
Task.WaitAll(tasks.ToArray())
End Sub
End Module
' The example displays output like the following:
' regain --> irnaeg
' ordain --> rioadn
' reason --> soearn
' rained --> rinade
' rioter --> itrore
' senior --> norise
' rental --> atnerl
' editor --> oteird
この例では、ロックによって保護される 1 つの乱数ジェネレーターを初期化します。 ロックが必要な場合は、クラストピックの「System.Random クラスとスレッドセーフ」を Random 参照してください。
注釈
呼び出し StartNew は機能的には、コンストラクターの 1 つを Task 使用して作成し、メソッドを Start 呼び出して実行のスケジュールを設定することと同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単なAction方法として、オブジェクトでメソッドを使用できます。 詳細とコード例については、「.NET での並列プログラミング」ブログの 「Task.Run vs Task.Factory.StartNew 」を参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)
指定された関数デリゲート、取り消しトークン、作成オプション、およびタスク スケジューラーの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);member this.StartNew : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- function
- Func<TResult>
タスクを通じて取得される結果を返す関数デリゲート。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
- scheduler
- TaskScheduler
作成されたタスクをスケジュールするときに使用するタスク スケジューラー。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。
注釈
StartNew の呼び出しは、機能的には、そのコンストラクターの 1 つを Task<TResult> 使用して作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<TResult>)
指定された関数デリゲートの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function);member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of TResult)) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- function
- Func<TResult>
タスクを通じて取得される結果を返す関数デリゲート。
戻り値
開始されたタスク。
例外
function 引数が null です。
例
次の例は、2 つの乱数を生成し、合計を入力するようにユーザーに求める単純な追加アプリです。 次に、回答が正しいかどうか、またはユーザーの応答が有効な数値でない場合は、有効な数値を再入力するように求めるメッセージが表示されます。 これは StartNew 、追加する乱数を Task<TResult> 返すオブジェクトを作成するために使用されます。
using System;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
Random rnd = new Random();
Task<int>[] tasks = new Task<int>[2];
Object obj = new Object();
while (true) {
for (int ctr = 0; ctr <= 1; ctr++)
tasks[ctr] = Task.Factory.StartNew(() => { int i = 0;
lock(obj) {
i = rnd.Next(101);
}
return i; });
Task.WaitAll(tasks);
int n1 = tasks[0].Result;
int n2 = tasks[1].Result;
int result = n1 + n2;
bool validInput = false;
while (! validInput) {
ShowMessage(n1, n2);
string userInput = Console.ReadLine();
// Process user input.
if (userInput.Trim().ToUpper() == "X") return;
int answer;
validInput = Int32.TryParse(userInput, out answer);
if (! validInput)
Console.WriteLine("Invalid input. Try again, but enter only numbers. ");
else if (answer == result)
Console.WriteLine("Correct!");
else
Console.WriteLine("Incorrect. The correct answer is {0}.", result);
}
}
}
private static void ShowMessage(int n1, int n2)
{
Console.WriteLine("\nEnter 'x' to exit...");
Console.Write("{0} + {1} = ", n1, n2);
}
}
// The example displays the following output:
// Enter 'x' to exit...
// 15 + 11 = 26
// Correct!
//
// Enter 'x' to exit...
// 75 + 33 = adc
// Invalid input. Try again, but enter only numbers.
//
// Enter 'x' to exit...
// 75 + 33 = 108
// Correct!
//
// Enter 'x' to exit...
// 67 + 55 = 133
// Incorrect. The correct answer is 122.
//
// Enter 'x' to exit...
// 92 + 51 = 133
// Incorrect. The correct answer is 143.
//
// Enter 'x' to exit...
// 81 + 65 = x
Imports System.Threading.Tasks
Module AdditionTester
Public Sub Main()
Dim rnd As New Random()
Dim tasks(1) As Task(Of Integer)
Dim obj As New Object()
Do While True
For ctr As Integer = 0 To 1
tasks(ctr) = Task.Factory.StartNew(Function()
Dim i As Integer
SyncLock(obj)
i = rnd.Next(101)
End SyncLock
Return i
End Function)
Next
Task.WaitAll(tasks)
Dim n1 As Integer = tasks(0).Result
Dim n2 As Integer = tasks(1).Result
Dim result As Integer = n1 + n2
Dim validInput As Boolean = False
Do While Not validInput
ShowMessage(n1, n2)
Dim userInput As String = Console.ReadLine()
' Process user input.
If userInput.Trim().ToUpper = "X" Then Exit Sub
Dim answer As Integer
validInput = Int32.TryParse(userInput, answer)
If Not validInput Then
Console.WriteLine("Invalid input. Try again, but enter only numbers. ")
Else If answer = result Then
Console.WriteLine("Correct!")
Else
Console.WriteLine("Incorrect. The correct answer is {0}.", result)
End If
Loop
Loop
End Sub
Private Sub ShowMessage(n1 As Integer, n2 As Integer)
Console.WriteLine()
Console.WriteLine("Enter 'x' to exit...")
Console.Write("{0} + {1} = ", n1, n2)
End Sub
End Module
' The example displays output like the following:
' Enter 'x' to exit...
' 15 + 11 = 26
' Correct!
'
' Enter 'x' to exit...
' 75 + 33 = adc
' Invalid input. Try again, but enter only numbers.
'
' Enter 'x' to exit...
' 75 + 33 = 108
' Correct!
'
' Enter 'x' to exit...
' 67 + 55 = 133
' Incorrect. The correct answer is 122.
'
' Enter 'x' to exit...
' 92 + 51 = 133
' Incorrect. The correct answer is 143.
'
' Enter 'x' to exit...
' 81 + 65 = x
注釈
呼び出し StartNew は、関数的には、コンストラクターの 1 つを Task<TResult> 使用して作成し、そのコンストラクターを呼び出 Start して実行のスケジュールを設定することと同じです。
.NET Framework 4.5 以降では、既定のパラメーターをTask.Run<TResult>(Func<TResult>)使用して呼び出す簡単な方法としてメソッドを呼び出StartNewすことができます。 ただし、2 つのメソッドの動作には違いがあることに注意してください。Task.Run<TResult>(Func<TResult>)既定では、現在Task<TResult>のインスタンスにアタッチするオプションでTaskCreationOptions.AttachedToParent開始された子タスクはStartNew<TResult>(Func<TResult>)許可されません。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<Object,TResult>, Object)
指定された関数デリゲートおよび状態の型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state);member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- state
- Object
function デリゲートによって使用されるデータを格納しているオブジェクト。
戻り値
開始されたタスク。
例外
function が nullです。
注釈
StartNew の呼び出しは、機能的には、そのコンストラクターの 1 つを Task<TResult> 使用して作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<TResult>, CancellationToken)
指定された関数デリゲートおよび取り消しトークンの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.CancellationToken cancellationToken);member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- function
- Func<TResult>
タスクを通じて取得される結果を返す関数デリゲート。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
function が nullです。
例
次の例では、2 つのタスクを使用して、F100 = F100-1 + F100-2 で終わるフィボナッチ シーケンスを、シード値 F1= 1、F2 = 1、F1 = 0、F2= 1 で計算します。 約半分の時間は、操作の実行時にキャンセル トークンが設定されます。 この例の出力は、2 つのタスクが正常に完了した場合とトークンが取り消された場合の結果を示しています。
using System;
using System.Collections.Generic;
using System.Numerics;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
var rnd = new Random();
var tasks = new List<Task<BigInteger[]>>();
var source = new CancellationTokenSource();
var token = source.Token;
for (int ctr = 0; ctr <= 1; ctr++) {
int start = ctr;
tasks.Add(Task.Run( () => { BigInteger[] sequence = new BigInteger[100];
sequence[0] = start;
sequence[1] = 1;
for (int index = 2; index <= sequence.GetUpperBound(0); index++) {
token.ThrowIfCancellationRequested();
sequence[index] = sequence[index - 1] + sequence[index - 2];
}
return sequence;
}, token));
}
if (rnd.Next(0, 2) == 1)
source.Cancel();
try {
Task.WaitAll(tasks.ToArray());
foreach (var t in tasks)
Console.WriteLine("{0}, {1}...{2:N0}", t.Result[0], t.Result[1],
t.Result[99]);
}
catch (AggregateException e) {
foreach (var ex in e.InnerExceptions)
Console.WriteLine("{0}: {1}", ex.GetType().Name, ex.Message);
}
}
}
// The example displays either the following output:
// 0, 1...218,922,995,834,555,169,026
// 1, 1...354,224,848,179,261,915,075
// or the following output:
// TaskCanceledException: A task was canceled.
// TaskCanceledException: A task was canceled.
Imports System.Collections.Generic
Imports System.Numerics
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim rnd As New Random()
Dim tasks As New List(Of Task(Of BigInteger()))
Dim source As New CancellationTokenSource
Dim token As CancellationToken = source.Token
For ctr As Integer = 0 To 1
Dim start As Integer = ctr
tasks.Add(Task.Run(Function()
Dim sequence(99) As BigInteger
sequence(0) = start
sequence(1) = 1
For index As Integer = 2 To sequence.GetUpperBound(0)
token.ThrowIfCancellationRequested()
sequence(index) = sequence(index - 1) + sequence(index - 2)
Next
Return sequence
End Function, token))
Next
If rnd.Next(0, 2) = 1 Then source.Cancel
Try
Task.WaitAll(tasks.ToArray())
For Each t In tasks
Console.WriteLine("{0}, {1}...{2:N0}", t.Result(0), t.Result(1),
t.Result(99))
Next
Catch e As AggregateException
For Each ex In e.InnerExceptions
Console.WriteLine("{0}: {1}", ex.GetType().Name, ex.Message)
Next
End Try
End Sub
End Module
' The example displays either the following output:
' 0, 1...218,922,995,834,555,169,026
' 1, 1...354,224,848,179,261,915,075
' or the following output:
' TaskCanceledException: A task was canceled.
' TaskCanceledException: A task was canceled.
注釈
呼び出し StartNew は、関数的には、コンストラクターの 1 つを Task<TResult> 使用して作成し、そのコンストラクターを呼び出 Start して実行のスケジュールを設定することと同じです。
.NET Framework 4.5 以降では、既定のパラメーターをTask.Run<TResult>(Func<TResult>, CancellationToken)使用して簡単に呼び出すStartNew<TResult>(Func<TResult>, CancellationToken)方法としてこのメソッドを使用できます。 ただし、2 つのメソッドの動作には違いがあることに注意してください。Task.Run<TResult>(Func<TResult>, CancellationToken)既定では、現在Task<TResult>のインスタンスにアタッチするオプションでTaskCreationOptions.AttachedToParent開始された子タスクはStartNew<TResult>(Func<TResult>, CancellationToken)許可されません。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<TResult>, TaskCreationOptions)
指定された関数デリゲートおよび作成オプションの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);member this.StartNew : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- function
- Func<TResult>
タスクを通じて取得される結果を返す関数デリゲート。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
戻り値
開始されたタスク。
例外
function が nullです。
creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。
注釈
StartNew の呼び出しは、機能的には、そのコンストラクターの 1 つを Task<TResult> 使用して作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken)
指定された関数デリゲート、乗田い、および取り消しトークンの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- state
- Object
function デリゲートによって使用されるデータを格納しているオブジェクト。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
function が nullです。
注釈
StartNew の呼び出しは、機能的には、そのコンストラクターの 1 つを Task<TResult> 使用して作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)
指定された関数デリゲート、状態、および作成オプションの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);member this.StartNew : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- state
- Object
function デリゲートによって使用されるデータを格納しているオブジェクト。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
戻り値
開始されたタスク。
例外
function が nullです。
creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。
注釈
StartNew の呼び出しは、機能的には、そのコンストラクターの 1 つを Task<TResult> 使用して作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。
こちらもご覧ください
適用対象
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)
指定された関数デリゲート、状態、取り消しトークン、作成オプション、およびタスク スケジューラーの型 TResult のタスクを作成して開始します。
public:
generic <typename TResult>
System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)型パラメーター
- TResult
タスクで使用できる結果の種類。
パラメーター
- state
- Object
function デリゲートによって使用されるデータを格納しているオブジェクト。
- cancellationToken
- CancellationToken
新しいタスクに割り当てられる取り消しトークン。
- creationOptions
- TaskCreationOptions
作成されたタスクの動作を制御する列挙値のいずれか。
- scheduler
- TaskScheduler
作成されたタスクをスケジュールするときに使用するタスク スケジューラー。
戻り値
開始されたタスク。
例外
指定された CancellationToken は既に破棄されています。
creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。
注釈
StartNew の呼び出しは、機能的には、そのコンストラクターの 1 つを Task<TResult> 使用して作成し、実行のスケジュールを設定するために呼び出すこと Start と同じです。
.NET Framework 4.5 以降では、既定のRunパラメーターを使用して呼び出すStartNew簡単な方法として、オブジェクトでメソッドActionを使用できます。 詳細とコード例については、「.NET による並列プログラミング」ブログの 「Task.Run」と「Task.Factory.StartNew 」のエントリを参照してください。