Task コンストラクター

定義

名前空間:: System.Threading.Tasks

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

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

アセンブリ:: 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)	指定したアクション、状態、およびTaskを使用して、新しいCancellationTokenを初期化します。
Task(Action<Object>, Object, TaskCreationOptions)	指定したアクション、状態、およびオプションを使用して、新しい Task を初期化します。
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	指定したアクション、状態、およびオプションを使用して、新しい Task を初期化します。

Task(Action)

ソース:: Task.cs

ソース:: Task.cs

ソース:: 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

次の例は同じですが、 Run(Action) メソッドを使用して 1 回の操作でタスクをインスタンス化して実行した点が異なります。このメソッドは、タスクを表す 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.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(Action, TaskCreationOptions)

ソース:: Task.cs

ソース:: Task.cs

ソース:: 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.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.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

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

ArgumentNullException

action引数は null です。

ArgumentOutOfRangeException

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

注釈

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

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

適用対象

Task(Action<Object>, Object, CancellationToken)

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

ソース:: Task.cs

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

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

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

ArgumentNullException

action引数は null です。

注釈

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

適用対象

Task(Action<Object>, Object, TaskCreationOptions)

ソース:: Task.cs

ソース:: Task.cs

ソース:: 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.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

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

ArgumentNullException

action引数は null です。

ArgumentOutOfRangeException

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

注釈

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

適用対象

フィードバック

このページはお役に立ちましたか?