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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый 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) для создания задач, которые извлекают имена файлов в указанных каталогах. Все задачи записывают имена файлов в один 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) метод для создания экземпляра и выполнения задачи в одной операции. Метод возвращает 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) метода. Единственным преимуществом, предлагаемым этим конструктором, является то, что он позволяет отделить экземпляр объекта от вызова задачи.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

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)

Параметры

Исключения

Комментарии

Применяется к

Обратная связь