TaskFactory.StartNew メソッド

定義

タスクを作成して開始します。

オーバーロード

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

指定されたアクション デリゲート、状態、取り消しトークン、作成オプション、およびタスク スケジューラーのタスクを作成して開始します。

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

指定されたアクション デリゲート、取り消しトーク、作成オプション、および状態のタスクを作成して開始します。

StartNew(Action<Object>, Object, TaskCreationOptions)

指定されたアクション デリゲート、状態、および作成オプションのタスクを作成して開始します。

StartNew(Action<Object>, Object, CancellationToken)

指定されたアクション デリゲート、状態、および取り消しトークンのタスクを作成して開始します。

StartNew(Action, CancellationToken)

指定されたアクション デリゲートおよび取り消しトークンのタスクを作成して開始します。

StartNew(Action, TaskCreationOptions)

指定されたアクション デリゲートおよび作成オプションのタスクを作成して開始します。

StartNew(Action)

指定されたアクション デリゲートのタスクを作成して開始します。

StartNew(Action<Object>, Object)

指定されたアクション デリゲートおよび状態のタスクを作成して開始します。

StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

指定された関数デリゲート、取り消しトークン、作成オプション、およびタスク スケジューラーの型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<TResult>)

指定された関数デリゲートの型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<Object,TResult>, Object)

指定された関数デリゲートおよび状態の型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<TResult>, CancellationToken)

指定された関数デリゲートおよび取り消しトークンの型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<TResult>, TaskCreationOptions)

指定された関数デリゲートおよび作成オプションの型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken)

指定された関数デリゲート、乗田い、および取り消しトークンの型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)

指定された関数デリゲート、状態、および作成オプションの型 TResult のタスクを作成して開始します。

StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

指定された関数デリゲート、状態、取り消しトークン、作成オプション、およびタスク スケジューラーの型 TResult のタスクを作成して開始します。

注釈

.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.Task
Public Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task

パラメーター

action
Action<Object>

非同期で実行するアクション デリゲート。

state
Object

action デリゲートによって使用されるデータを格納しているオブジェクト。

cancellationToken
CancellationToken

新しいタスクに割り当てられる取り消しトークン。

creationOptions
TaskCreationOptions

作成されたタスクの動作を制御する列挙値のいずれか。

scheduler
TaskScheduler

作成されたタスクをスケジュールするときに使用するタスク スケジューラー。

戻り値

Task

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

actionnull です。

または

schedulernull です。

creationOptions 引数に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。

注釈

StartNew の呼び出しは、そのコンストラクターの1つを使用してタスクを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的に同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、.NET の並列プログラミングに関するブログの「 タスク 」を参照してください。

こちらもご覧ください

適用対象

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.Task
Public Function StartNew (action As Action, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task

パラメーター

action
Action

非同期で実行するアクション デリゲート。

cancellationToken
CancellationToken

新しいタスクに割り当てられる取り消しトークン。

creationOptions
TaskCreationOptions

作成されたタスクの動作を制御する列挙値のいずれか。

scheduler
TaskScheduler

作成されたタスクをスケジュールするときに使用するタスク スケジューラー。

戻り値

Task

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

actionnull です。

または schedulernull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。

注釈

StartNew の呼び出しは、そのコンストラクターの1つを使用してタスクを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的に同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、.NET の並列プログラミングに関するブログの「 タスク 」を参照してください。

こちらもご覧ください

適用対象

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.Task
Public Function StartNew (action As Action(Of Object), state As Object, creationOptions As TaskCreationOptions) As Task

パラメーター

action
Action<Object>

非同期で実行するアクション デリゲート。

state
Object

action デリゲートによって使用されるデータを格納しているオブジェクト。

creationOptions
TaskCreationOptions

作成されたタスクの動作を制御する列挙値のいずれか。

戻り値

Task

開始されたタスク。

例外

actionnull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。

注釈

StartNew の呼び出しは、そのコンストラクターの1つを使用してタスクを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的に同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、.NET の並列プログラミングに関するブログの「 タスク 」を参照してください。

こちらもご覧ください

適用対象

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.Task
Public Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken) As Task

パラメーター

action
Action<Object>

非同期で実行するアクション デリゲート。

state
Object

action デリゲートによって使用されるデータを格納しているオブジェクト。

cancellationToken
CancellationToken

新しいタスクに割り当てられる取り消しトークン。

戻り値

Task

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

actionnull です。

次の例では、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つの乱数ジェネレーターを初期化しています。これは、ロックによって保護されています。 ロックが必要な場合は、クラスのトピックの「Random クラスとスレッドセーフ」を参照してください Random 。 乱数ジェネレーターが破損している可能性を処理するために、キャンセルトークンがタスクに渡されます。 2つの乱数が0の場合、メソッドは、乱数ジェネレーターが破損していると見なし、キャンセルトークンを設定します。 chars単語内の6文字を含む配列を並べ替える前に、メソッドはメソッドを呼び出して、 CancellationToken.ThrowIfCancellationRequested OperationCanceledException トークンが取り消された場合にをスローします。

注釈

StartNew の呼び出しは、そのコンストラクターのいずれかを使用してタスクを作成し、 を呼び出して実行のスケジュールを設定するのと機能的 Start に同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、.NET の並列プログラミングに関するブログの「 タスク 」を参照してください。

こちらもご覧ください

適用対象

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.Task
Public Function StartNew (action As Action, cancellationToken As CancellationToken) As Task

パラメーター

action
Action

非同期で実行するアクション デリゲート。

cancellationToken
CancellationToken

新しいタスクに割り当てられる取り消しトークン。

戻り値

Task

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

actionnull です。

次の例では、 StartNew(Action, CancellationToken) メソッドを呼び出して、C:\Windows\System32 ディレクトリ内のファイルを反復処理するタスクを作成します。 ラムダ式は、 メソッドを Parallel.ForEach 呼び出して、各ファイルに関する情報を オブジェクトに追加 List<T> します。 ループによって呼び出されるデタッチされた入れ子になった各タスクは、キャンセル トークンの状態を確認し、取り消しが要求された場合は Parallel.ForEach メソッドを呼び出 CancellationToken.ThrowIfCancellationRequested します。 メソッド CancellationToken.ThrowIfCancellationRequested は、呼び出 OperationCanceledException し元のスレッドが メソッドを呼び出す際にブロック catch で処理される例外をスロー 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 Start スケジュールを設定するのと機能的に同じです。

.NET Framework 4.5 から、既定のパラメーターを使用して を簡単に呼び出す方法として、 Task.Run(Action, CancellationToken) StartNew(Action, CancellationToken) メソッドを使用できます。 ただし、 に関する 2 つのメソッドの動作には違いがあります。ただし、既定では、 オプションを使用して開始された子タスクは現在のインスタンスにアタッチできます。 Task.Run(Action, CancellationToken) TaskCreationOptions.AttachedToParent Task 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.Task
Public Function StartNew (action As Action, creationOptions As TaskCreationOptions) As Task

パラメーター

action
Action

非同期で実行するアクション デリゲート。

creationOptions
TaskCreationOptions

作成されたタスクの動作を制御する列挙値のいずれか。

戻り値

Task

開始されたタスク。

例外

actionnull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。

注釈

StartNew の呼び出しは、そのコンストラクターのいずれかを使用してタスクを作成し、 を呼び出して実行のスケジュールを設定するのと機能的 Start に同じです。

.NET Framework 4.5 より、既定のパラメーターで を呼び出す簡単な方法として、 オブジェクトで メソッド Run Action StartNew を使用できます。 詳細とコード例については、「.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.Task
Public Function StartNew (action As Action) As Task

パラメーター

action
Action

非同期で実行するアクション デリゲート。

戻り値

Task

開始されたタスク。

例外

action 引数が null です。

次の例では、 メソッドを使用して、乱数を生成するデリゲートを繰り返し呼び出し、それを Unicode コード ポイントとして解釈し StartNew(Action) 、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)

注釈

を呼び出すのは、そのコンストラクターの 1 つを使用してタスクを作成し、 メソッドを呼び出してタスクの実行をスケジュールするのと機能的 StartNew Task.Start に同じです。

.NET Framework 4.5 から、既定のパラメーターを使用して を簡単に呼び出す方法として、 Task.Run(Action) StartNew(Action) メソッドを使用できます。 ただし、 に関する 2 つのメソッドの動作には違いがあります。ただし、既定では、 オプションを使用して開始された子タスクは現在のインスタンスにアタッチできます。 Task.Run(Action) TaskCreationOptions.AttachedToParent Task 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.Task
Public Function StartNew (action As Action(Of Object), state As Object) As Task

パラメーター

action
Action<Object>

非同期で実行するアクション デリゲート。

state
Object

action デリゲートによって使用されるデータを格納しているオブジェクト。

戻り値

Task

開始されたタスク。

例外

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 Task Start 機能的に同じです。

.NET Framework 4.5 より、既定のパラメーターで を呼び出す簡単な方法として、 オブジェクトで メソッド Run Action StartNew を使用できます。 詳細とコード例については、「.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

作成されたタスクをスケジュールするときに使用するタスク スケジューラー。

戻り値

Task<TResult>

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

functionnull です。

または schedulernull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。

注釈

StartNew の呼び出しは、 Task<TResult> そのコンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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>

タスクを通じて取得される結果を返す関数デリゲート。

戻り値

Task<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 は、 Task<TResult> コンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、 Task.Run<TResult>(Func<TResult>) 既定のパラメーターを使用してを呼び出す簡単な方法として、メソッドを呼び出すことができ StartNew ます。 ただし、に関する2つのメソッドの動作に違いがあることに注意してください。 Task.Run<TResult>(Func<TResult>) 既定では、現在の TaskCreationOptions.AttachedToParent インスタンスにアタッチするオプションで子タスクを開始することはできませんが、ではを使用でき Task<TResult> StartNew<TResult>(Func<TResult>) ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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

タスクで使用できる結果の型。

パラメーター

function
Func<Object,TResult>

タスクを通じて取得される結果を返す関数デリゲート。

state
Object

function デリゲートによって使用されるデータを格納しているオブジェクト。

戻り値

Task<TResult>

開始されたタスク。

例外

functionnull です。

注釈

StartNew の呼び出しは、 Task<TResult> そのコンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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

新しいタスクに割り当てられる取り消しトークン。

戻り値

Task<TResult>

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

functionnull です。

次の例では、2つのタスクを使用して、F100 = F100-1 + F100 と、シード値 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 は、 Task<TResult> コンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Task.Run<TResult>(Func<TResult>, CancellationToken) 簡単に呼び出す方法として、メソッドを使用でき StartNew<TResult>(Func<TResult>, CancellationToken) ます。 ただし、に関する2つのメソッドの動作に違いがあることに注意してください。 Task.Run<TResult>(Func<TResult>, CancellationToken) 既定では、現在の TaskCreationOptions.AttachedToParent インスタンスにアタッチするオプションで子タスクを開始することはできませんが、ではを使用でき Task<TResult> StartNew<TResult>(Func<TResult>, CancellationToken) ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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

作成されたタスクの動作を制御する列挙値のいずれか。

戻り値

Task<TResult>

開始されたタスク。

例外

functionnull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。

注釈

StartNew の呼び出しは、 Task<TResult> そのコンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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

タスクで使用できる結果の型。

パラメーター

function
Func<Object,TResult>

タスクを通じて取得される結果を返す関数デリゲート。

state
Object

function デリゲートによって使用されるデータを格納しているオブジェクト。

cancellationToken
CancellationToken

新しいタスクに割り当てられる取り消しトークン。

戻り値

Task<TResult>

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

functionnull です。

注釈

StartNew の呼び出しは、 Task<TResult> そのコンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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

タスクで使用できる結果の型。

パラメーター

function
Func<Object,TResult>

タスクを通じて取得される結果を返す関数デリゲート。

state
Object

function デリゲートによって使用されるデータを格納しているオブジェクト。

creationOptions
TaskCreationOptions

作成されたタスクの動作を制御する列挙値のいずれか。

戻り値

Task<TResult>

開始されたタスク。

例外

functionnull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。

注釈

StartNew の呼び出しは、 Task<TResult> そのコンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象

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

タスクで使用できる結果の型。

パラメーター

function
Func<Object,TResult>

タスクを通じて取得される結果を返す関数デリゲート。

state
Object

function デリゲートによって使用されるデータを格納しているオブジェクト。

cancellationToken
CancellationToken

新しいタスクに割り当てられる取り消しトークン。

creationOptions
TaskCreationOptions

作成されたタスクの動作を制御する列挙値のいずれか。

scheduler
TaskScheduler

作成されたタスクをスケジュールするときに使用するタスク スケジューラー。

戻り値

Task<TResult>

開始されたタスク。

例外

指定された CancellationToken は既に破棄されています。

functionnull です。

または schedulernull です。

creationOptions に無効な TaskCreationOptions 値が指定されています。 詳細については、FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions) の「解説」を参照してください。

注釈

StartNew の呼び出しは、 Task<TResult> そのコンストラクターの1つを使用してを作成し、を呼び出して Start 実行のスケジュールを設定することと機能的には同じです。

.NET Framework 4.5 以降では、既定のパラメーターを使用してを Run Action 簡単に呼び出す方法として、メソッドをオブジェクトと共に使用でき StartNew ます。 詳細とコード例については、「.NET を使用した並列プログラミング」の「 タスクの実行 」を参照してください。

こちらもご覧ください

適用対象