Task コンストラクター

リファレンス

定義

名前空間:: System.Threading.Tasks

アセンブリ:: System.Threading.Tasks.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

新しい Task を初期化します。

オーバーロード

Task(Action)	指定したアクションで新しい Task を初期化します。
Task(Action, CancellationToken)	指定したアクションおよび Task で新しい CancellationToken を初期化します。
Task(Action, TaskCreationOptions)	指定したアクションと作成オプションで新しい Task を初期化します。
Task(Action<Object>, Object)	指定したアクションと状態で新しい Task を初期化します。
Task(Action, CancellationToken, TaskCreationOptions)	指定したアクションと作成オプションで新しい Task を初期化します。
Task(Action<Object>, Object, CancellationToken)	指定したアクション、状態、および CancellationTokenを使用して、新しい Task を初期化します。
Task(Action<Object>, Object, TaskCreationOptions)	指定したアクション、状態、およびオプションで新しい Task を初期化します。
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	指定したアクション、状態、およびオプションで新しい Task を初期化します。

Task(Action)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクションで新しい Task を初期化します。

public:
 Task(Action ^ action);

public Task (Action action);

new System.Threading.Tasks.Task : Action -> System.Threading.Tasks.Task

Public Sub New (action As Action)

パラメーター

action: Action

タスクで実行するコードを表すデリゲート。

例外

ArgumentNullException

action 引数が null です。

例

次の例では、コンストラクターを Task(Action) 使用して、指定したディレクトリ内のファイル名を取得するタスクを作成します。すべてのタスクは、ファイル名を 1 つの ConcurrentBag<T> オブジェクトに書き込みます。次に、メソッドを WaitAll(Task[]) 呼び出してすべてのタスクが完了したことを確認し、オブジェクトに書き込まれたファイル名の合計数を ConcurrentBag<T> 表示します。

using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

public class Example
{
   public static async Task Main()
   {
      var list = new ConcurrentBag<string>();
      string[] dirNames = { ".", ".." };
      List<Task> tasks = new List<Task>();
      foreach (var dirName in dirNames) {
         Task t = new Task( () => { foreach(var path in Directory.GetFiles(dirName))
                                    list.Add(path); }  );
         tasks.Add(t);
         t.Start();
      }
      await Task.WhenAll(tasks.ToArray());
      foreach (Task t in tasks)
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status);
         
      Console.WriteLine("Number of files read: {0}", list.Count);
   }
}
// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

open System.Collections.Concurrent
open System.IO
open System.Threading.Tasks

let main =
    task {
        let list = ConcurrentBag<string>()
        let dirNames = [ "."; ".." ]
        let tasks = ResizeArray()

        for dirName in dirNames do
            let t =
                new Task(fun () ->
                    for path in Directory.GetFiles dirName do
                        list.Add path)

            tasks.Add t
            t.Start()

        do! tasks.ToArray() |> Task.WhenAll

        for t in tasks do
            printfn $"Task {t.Id} Status: {t.Status}"

        printfn $"Number of files read: {list.Count}"
    }

// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

Imports System.Collections.Concurrent
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim list As New ConcurrentBag(Of String)()
      Dim dirNames() As String = { ".", ".." }
      Dim tasks As New List(Of Task)()
      For Each dirName In dirNames 
         Dim t As New Task( Sub()
                               For Each path In Directory.GetFiles(dirName)
                                  list.Add(path)
                               Next
                            End Sub  )
         tasks.Add(t)
         t.Start()
      Next
      Task.WaitAll(tasks.ToArray())
      For Each t In tasks
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status)
      Next   
      Console.WriteLine("Number of files read: {0}", list.Count)
   End Sub
End Module
' The example displays output like the following:
'       Task 1 Status: RanToCompletion
'       Task 2 Status: RanToCompletion
'       Number of files read: 23

次の例は同じですが、メソッドを使用して 1 回の Run(Action) 操作でタスクをインスタンス化して実行した点が除きます。メソッドは、タスクを Task 表すオブジェクトを返します。

using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var list = new ConcurrentBag<string>();
      string[] dirNames = { ".", ".." };
      List<Task> tasks = new List<Task>();
      foreach (var dirName in dirNames) {
         Task t = Task.Run( () => { foreach(var path in Directory.GetFiles(dirName)) 
                                       list.Add(path); }  );
         tasks.Add(t);
      }
      Task.WaitAll(tasks.ToArray());
      foreach (Task t in tasks)
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status);
         
      Console.WriteLine("Number of files read: {0}", list.Count);
   }
}
// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

open System.Collections.Concurrent
open System.IO
open System.Threading.Tasks

let list = ConcurrentBag<string>()
let dirNames = [ "."; ".." ]
let tasks = ResizeArray()

for dirName in dirNames do
    let t =
        Task.Run(fun () ->
            for path in Directory.GetFiles dirName do
                list.Add path)

    tasks.Add t

tasks.ToArray() |> Task.WaitAll

for t in tasks do
    printfn $"Task {t.Id} Status: {t.Status}"

printfn $"Number of files read: {list.Count}"

// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

Imports System.Collections.Concurrent
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim list As New ConcurrentBag(Of String)()
      Dim dirNames() As String = { ".", ".." }
      Dim tasks As New List(Of Task)()
      For Each dirName In dirNames 
         Dim t As Task = Task.Run( Sub()
                                      For Each path In Directory.GetFiles(dirName) 
                                         list.Add(path)
                                      Next
                                   End Sub  )
         tasks.Add(t)
      Next
      Task.WaitAll(tasks.ToArray())
      For Each t In tasks
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status)
      Next   
      Console.WriteLine("Number of files read: {0}", list.Count)
   End Sub
End Module
' The example displays output like the following:
'       Task 1 Status: RanToCompletion
'       Task 2 Status: RanToCompletion
'       Number of files read: 23

注釈

このコンストラクターは、タスクの作成と開始を分離する必要がある高度なシナリオでのみ使用する必要があります。

このコンストラクターを呼び出す代わりに、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 Task.Run(Action) メソッドまたは TaskFactory.StartNew(Action) メソッドを呼び出すことです。

API のコンシューマーが待機するものを持つためだけにアクションのないタスクが必要な場合は、 TaskCompletionSource<TResult> を使用する必要があります。

こちらもご覧ください

Run(Action)

適用対象

Task(Action, CancellationToken)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクションおよび Task で新しい CancellationToken を初期化します。

public:
 Task(Action ^ action, System::Threading::CancellationToken cancellationToken);

public Task (Action action, System.Threading.CancellationToken cancellationToken);

new System.Threading.Tasks.Task : Action * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Sub New (action As Action, cancellationToken As CancellationToken)

パラメーター

action: Action

タスクで実行するコードを表すデリゲート。

cancellationToken: CancellationToken

新しいタスクが観察する CancellationToken。

例外

ObjectDisposedException

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

ArgumentNullException

action 引数が null です。

例

次の例では、コンストラクターを Task(Action, CancellationToken) 呼び出して、C:\Windows\System32 ディレクトリ内のファイルを反復処理するタスクを作成します。ラムダ式は、メソッドを Parallel.ForEach 呼び出して、各ファイルに関する情報をオブジェクトに List<T> 追加します。ループによって Parallel.ForEach 呼び出されたデタッチされた入れ子になった各タスクは、取り消しトークンの状態をチェックし、取り消しが要求された場合はメソッドを CancellationToken.ThrowIfCancellationRequested 呼び出します。メソッドは CancellationToken.ThrowIfCancellationRequested 、呼び出し元のスレッドがメソッドを OperationCanceledException 呼び出すときにブロック catch で処理される例外を Task.Wait スローします。 Startその後、メソッドが呼び出されてタスクが開始されます。

using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static async Task Main()
   {
      var tokenSource = new CancellationTokenSource();
      var token = tokenSource.Token;
      var files = new List<Tuple<string, string, long, DateTime>>();
      
      var t = new Task(() => { 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);
      t.Start();
      tokenSource.Cancel();
      try {
         await t; 
         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

open System
open System.IO
open System.Threading
open System.Threading.Tasks

let main =
    task {
        use tokenSource = new CancellationTokenSource()
        let token = tokenSource.Token
        let files = ResizeArray()

        let t =
            new Task(
                (fun () ->
                    let dir = @"C:\Windows\System32\"
                    let obj = obj ()

                    if Directory.Exists dir then
                        Parallel.ForEach(
                            Directory.GetFiles dir,
                            fun f ->
                                if token.IsCancellationRequested then
                                    token.ThrowIfCancellationRequested()

                                let fi = FileInfo f
                                lock obj (fun () -> files.Add(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc))
                        )
                        |> ignore),
                token
            )

        t.Start()
        tokenSource.Cancel()

        try
            do! t
            printfn $"Retrieved information for {files.Count} files."

        with :? AggregateException as e ->
            printfn "Exception messages:"

            for ie in e.InnerExceptions do
                printfn $"   {ie.GetType().Name}: {ie.Message}"

            printfn $"Task status: {t.Status}"
    }

main.Wait()

// 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 New Task(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)
      t.Start()
      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

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 Task.Run(Action, CancellationToken) メソッドと TaskFactory.StartNew(Action, CancellationToken) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

詳細については、「 Task Parallelism (Task Parallel Library)」および「 Managed Threads での取り消し」を参照してください。

適用対象

Task(Action, TaskCreationOptions)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクションと作成オプションで新しい Task を初期化します。

public:
 Task(Action ^ action, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action action, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action, creationOptions As TaskCreationOptions)

パラメーター

action: Action

タスクで実行するコードを表すデリゲート。

creationOptions: TaskCreationOptions

タスクの動作のカスタマイズに使用する TaskCreationOptions。

例外

ArgumentNullException

action 引数が null です。

ArgumentOutOfRangeException

creationOptions 引数が、TaskCreationOptions の無効な値を指定しています。

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 TaskFactory.StartNew(Action, TaskCreationOptions) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

適用対象

Task(Action<Object>, Object)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクションと状態で新しい Task を初期化します。

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state);

public Task (Action<object> action, object state);

public Task (Action<object?> action, object? state);

new System.Threading.Tasks.Task : Action<obj> * obj -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object)

パラメーター

action: Action<Object>

タスクで実行するコードを表すデリゲート。

state: Object

アクションによって使用されるデータを表すオブジェクト。

例外

ArgumentNullException

action 引数が null です。

例

次の例では、6 文字の単語の配列を定義します。その後、各単語はコンストラクターに Task(Action<Object>, Object) 引数として渡され、その Action<T> デリゲートは単語内の文字をスクランブルし、元の単語とそのスクランブルバージョンを表示します。

using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class Example
{
   public static async Task 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) {
         Task t = new Task( (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);
         t.Start();
         tasks.Add(t);
      }
      await Task.WhenAll(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

open System
open System.Threading.Tasks

let main =
    task {
        let tasks = ResizeArray()
        let rnd = Random()
        let lockObj = obj ()

        let words6 =
            [ "reason"
              "editor"
              "rioter"
              "rental"
              "senior"
              "regain"
              "ordain"
              "rained" ]

        for word6 in words6 do
            let t =
                new Task(
                    (fun word ->
                        let chars = (string word).ToCharArray()
                        let order = Array.zeroCreate<double> chars.Length

                        lock lockObj (fun () ->
                            for i = 0 to order.Length - 1 do
                                order[i] <- rnd.NextDouble())

                        Array.Sort(order, chars)
                        printfn $"{word} --> {new String(chars)}"),
                    word6
                )

            t.Start()
            tasks.Add t

        do! tasks.ToArray() |> Task.WhenAll
    }

main.Wait()

// 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
         Dim t As New Task( 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)
         t.Start()
         tasks.Add(t)
      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

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 TaskFactory.StartNew(Action<Object>, Object) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

こちらもご覧ください

StartNew(Action<Object>, Object)

適用対象

Task(Action, CancellationToken, TaskCreationOptions)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクションと作成オプションで新しい Task を初期化します。

public:
 Task(Action ^ action, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action action, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions)

パラメーター

action: Action

タスクで実行するコードを表すデリゲート。

cancellationToken: CancellationToken

新しいタスクが観察する CancellationToken。

creationOptions: TaskCreationOptions

タスクの動作のカスタマイズに使用する TaskCreationOptions。

例外

ObjectDisposedException

cancellationToken を作成した CancellationTokenSource は既に破棄されています。

ArgumentNullException

action 引数が null です。

ArgumentOutOfRangeException

creationOptions 引数が、TaskCreationOptions の無効な値を指定しています。

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 TaskFactory.StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

詳細については、「タスクの並列処理 (タスク並列ライブラリ)」と「タスクの取り消し」を参照してください。

適用対象

Task(Action<Object>, Object, CancellationToken)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクション、状態、および CancellationTokenを使用して、新しい Task を初期化します。

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public Task (Action<object> action, object state, System.Threading.CancellationToken cancellationToken);

public Task (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken);

new System.Threading.Tasks.Task : Action<obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object, cancellationToken As CancellationToken)

パラメーター

action: Action<Object>

タスクで実行するコードを表すデリゲート。

state: Object

アクションによって使用されるデータを表すオブジェクト。

cancellationToken: CancellationToken

新しいタスクが観察する CancellationToken。

例外

ObjectDisposedException

cancellationToken を作成した CancellationTokenSource は既に破棄されています。

ArgumentNullException

action 引数が null です。

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 TaskFactory.StartNew(Action<Object>, Object, CancellationToken) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

適用対象

Task(Action<Object>, Object, TaskCreationOptions)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクション、状態、およびオプションで新しい Task を初期化します。

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action<object> action, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);

public Task (Action<object?> action, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action<obj> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object, creationOptions As TaskCreationOptions)

パラメーター

action: Action<Object>

タスクで実行するコードを表すデリゲート。

state: Object

アクションによって使用されるデータを表すオブジェクト。

creationOptions: TaskCreationOptions

タスクの動作のカスタマイズに使用する TaskCreationOptions。

例外

ArgumentNullException

action 引数が null です。

ArgumentOutOfRangeException

creationOptions 引数が、TaskCreationOptions の無効な値を指定しています。

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 TaskFactory.StartNew(Action<Object>, Object, TaskCreationOptions) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

適用対象

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

指定したアクション、状態、およびオプションで新しい Task を初期化します。

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action<object> action, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);

public Task (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action<obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions)

パラメーター

action: Action<Object>

タスクで実行するコードを表すデリゲート。

state: Object

アクションによって使用されるデータを表すオブジェクト。

cancellationToken: CancellationToken

新しいタスクが観察する CancellationToken。

creationOptions: TaskCreationOptions

タスクの動作のカスタマイズに使用する TaskCreationOptions。

例外

ObjectDisposedException

cancellationToken を作成した CancellationTokenSource は既に破棄されています。

ArgumentNullException

action 引数が null です。

ArgumentOutOfRangeException

creationOptions 引数が、TaskCreationOptions の無効な値を指定しています。

注釈

このコンストラクターを呼び出すのではなく、オブジェクトをインスタンス化してタスクを Task 起動する最も一般的な方法は、静的 TaskFactory.StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) メソッドを呼び出すことです。このコンストラクターによって提供される唯一の利点は、オブジェクトのインスタンス化をタスク呼び出しから分離できるようにすることです。

適用対象

次の方法で共有

Task コンストラクター

定義

オーバーロード

Task(Action)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Task(Action, CancellationToken)

パラメーター

例外

例

注釈

適用対象

Task(Action, TaskCreationOptions)

パラメーター

例外

注釈

適用対象

Task(Action<Object>, Object)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Task(Action, CancellationToken, TaskCreationOptions)

パラメーター

例外

注釈

適用対象

Task(Action<Object>, Object, CancellationToken)

パラメーター

例外

注釈

適用対象

Task(Action<Object>, Object, TaskCreationOptions)

パラメーター

例外

注釈

適用対象

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

パラメーター

例外

注釈

適用対象

その他のリソース