TaskFactory.StartNew Метод

Ссылка

Определение

Пространство имен:: System.Threading.Tasks

Сборка:: System.Threading.Tasks.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

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

Создает и запускает задачу.

Перегрузки

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

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

action имеет значение null.

-или-

scheduler имеет значение null.

ArgumentOutOfRangeException

Аргумент creationOptions имеет недопустимое значение TaskCreationOptions. Дополнительные сведения см. в примечаниях к описанию FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions).

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в разделе Task.Run vs Task.Factory.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

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

action имеет значение null.

-или- scheduler имеет значение null.

ArgumentOutOfRangeException

Параметр creationOptions имеет недопустимое значение TaskCreationOptions. Дополнительные сведения см. в примечаниях к описанию FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions).

См. также раздел

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

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

Запущенная задача.

Исключения

ArgumentNullException

action имеет значение null.

ArgumentOutOfRangeException

Параметр creationOptions имеет недопустимое значение TaskCreationOptions.

См. также раздел

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

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

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

action имеет значение null.

Примеры

В следующем примере определяется массив из 6 букв. Затем каждое слово передается делегату Action<T> , который борется с словом и отображает исходное слово и его версию.

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

public class Example
{
   public static void Main()
   {
      CancellationTokenSource cts = new CancellationTokenSource();
      CancellationToken token = cts.Token;
      var tasks = new List<Task>();
      Random rnd = new Random();
      Object lockObj = new Object();
      String[] words6 = { "reason", "editor", "rioter", "rental",
                          "senior", "regain", "ordain", "rained" };

      foreach (var word6 in words6)
         tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
                                                      double[] order = new double[chars.Length];
                                                      token.ThrowIfCancellationRequested();
                                                      bool wasZero = false;
                                                      lock (lockObj) {
                                                         for (int ctr = 0; ctr < order.Length; ctr++) {
                                                             order[ctr] = rnd.NextDouble();
                                                             if (order[ctr] == 0) {
                                                                if (! wasZero) {
                                                                   wasZero = true;
                                                                }
                                                                else {
                                                                   cts.Cancel();
                                                                }
                                                             }
                                                         }
                                                      }
                                                      token.ThrowIfCancellationRequested();
                                                      Array.Sort(order, chars);
                                                      Console.WriteLine("{0} --> {1}", word,
                                                                        new String(chars));
                                                    }, word6, token));

      try {
         Task.WaitAll(tasks.ToArray());
      }
      catch (AggregateException e) {
         foreach (var ie in e.InnerExceptions) {
            if (ie is OperationCanceledException) {
               Console.WriteLine("The word scrambling operation has been cancelled.");
               break;
            }
            else {
               Console.WriteLine(ie.GetType().Name + ": " + ie.Message);
            }
         }
      }
      finally {
         cts.Dispose();
      }
   }
}
// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim cts As New CancellationTokenSource()
      Dim token As CancellationToken = cts.Token
      Dim tasks As New List(Of Task)()
      Dim rnd As New Random()
      Dim lockObj As New Object()
      Dim words6() As String = { "reason", "editor", "rioter", "rental",
                                 "senior", "regain", "ordain", "rained" }

      For Each word6 in words6
         tasks.Add(Task.Factory.StartNew( Sub(word)
                                              Dim chars() As Char = word.ToString().ToCharArray()
                                              Dim order(chars.Length - 1) As Double
                                              Dim wasZero As Boolean = False
                                              SyncLock lockObj
                                                 For ctr As Integer = 0 To order.Length - 1
                                                    order(ctr) = rnd.NextDouble()
                                                    If order(ctr) = 0 Then
                                                       If Not wasZero Then
                                                          wasZero = True
                                                       Else
                                                          cts.Cancel()
                                                       End If
                                                    End If
                                                 Next
                                              End SyncLock
                                              token.ThrowIfCancellationRequested()
                                              Array.Sort(order, chars)
                                              Console.WriteLine("{0} --> {1}", word,
                                                                new String(chars))
                                          End Sub, word6))
      Next
      Try
         Task.WaitAll(tasks.ToArray())
      Catch e As AggregateException
         For Each ie In e.InnerExceptions
            If TypeOf ie Is OperationCanceledException
               Console.WriteLine("The word scrambling operation has been cancelled.")
               Exit For
            Else
               Console.WriteLine(ie.GetType().Name + ": " + ie.Message)
            End If
         Next
      Finally
         cts.Dispose()
      End Try
   End Sub
End Module
' The example displays output like the following:
'       regain --> irnaeg
'       ordain --> rioadn
'       reason --> soearn
'       rained --> rinade
'       rioter --> itrore
'       senior --> norise
'       rental --> atnerl
'       editor --> oteird

Обратите внимание, что в примере инициализируется один генератор случайных чисел, защищенный блокировкой. Сведения о необходимости блокировки см. в разделе "System.Random class and thread safety" раздела Random класса. Чтобы справиться с возможностью повреждения генератора случайных чисел, в задачу передается маркер отмены. Если два случайных числа равны нулю, метод предполагает, что генератор случайных чисел поврежден и задает токен отмены. Перед сортировкой массива chars , содержащего шесть символов в слове, метод вызывает CancellationToken.ThrowIfCancellationRequested метод, чтобы вызвать OperationCanceledException исключение, если маркер был отменен.

См. также раздел

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

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

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

action имеет значение null.

Примеры

В следующем примере вызывается 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

Начиная с версии платформа .NET Framework 4.5, этот метод можно использовать Task.Run(Action, CancellationToken) как быстрый способ вызова StartNew(Action, CancellationToken) с параметрами по умолчанию. Однако обратите внимание, что между двумя методами существует разница в поведении: Task.Run(Action, CancellationToken) по умолчанию дочерние задачи, запущенные с TaskCreationOptions.AttachedToParent параметром присоединения к текущему Task экземпляру, в то время как StartNew(Action, CancellationToken) это делает. Дополнительные сведения и примеры кода см. в разделе Task.Run vs Task.Factory.StartNew в блоге по параллельному программированию с помощью .NET.

См. также раздел

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

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

Запущенная задача.

Исключения

ArgumentNullException

action имеет значение null.

ArgumentOutOfRangeException

Параметр creationOptions имеет недопустимое значение TaskCreationOptions.

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в разделе Task.Run vs Task.Factory.StartNew в блоге по параллельному программированию с помощью .NET.

См. также раздел

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

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

Запущенная задача.

Исключения

ArgumentNullException

Аргумент action имеет значение null.

Примеры

В следующем примере метод используется StartNew(Action) для многократного Action вызова делегата, который создает случайное число, интерпретирует его как кодовую точку Юникода, преобразует его в единицу кода в кодировке UTF16 и отображает сведения о результирующем символе или символах.

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)

Начиная с версии платформа .NET Framework 4.5, этот метод можно использовать Task.Run(Action) как быстрый способ вызова StartNew(Action) с параметрами по умолчанию. Однако обратите внимание, что между двумя методами существует разница в поведении: Task.Run(Action) по умолчанию дочерние задачи, запущенные с TaskCreationOptions.AttachedToParent параметром присоединения к текущему Task экземпляру, в то время как StartNew(Action) это делает. Дополнительные сведения и примеры кода см. в разделе Task.Run vs Task.Factory.StartNew в блоге по параллельному программированию с помощью .NET.

См. также раздел

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

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

Запущенная задача.

Исключения

ArgumentNullException

Аргумент 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

Обратите внимание, что в примере инициализируется один генератор случайных чисел, защищенный блокировкой. Сведения о необходимости блокировки см. в разделе "Класс System.Random и потокобезопасность" в Random разделе класса.

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в разделе Task.Run vs Task.Factory.StartNew в блоге по параллельному программированию с помощью .NET.

См. также раздел

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

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>

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

function имеет значение null.

-или- scheduler имеет значение null.

ArgumentOutOfRangeException

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.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>

Запущенная задача.

Исключения

ArgumentNullException

Аргумент function имеет значение null.

Примеры

Следующий пример представляет собой простое приложение сложения, которое создает два случайных числа и предлагает пользователю ввести сумму. Затем он указывает, является ли ответ правильным или, если ответ пользователя не является допустимым числом, предложит пользователю повторно ввести допустимое число. Используется 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

Начиная с версии платформа .NET Framework 4.5 можно быстро вызвать Task.Run<TResult>(Func<TResult>) метод StartNew с параметрами по умолчанию. Однако обратите внимание, что между двумя методами существует разница в поведении: Task.Run<TResult>(Func<TResult>) по умолчанию дочерние задачи, запущенные с TaskCreationOptions.AttachedToParent возможностью присоединения к текущему Task<TResult> экземпляру, в то время как StartNew<TResult>(Func<TResult>) это делает. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.StartNew в блоге о параллельном программировании с помощью .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>

Запущенная задача.

Исключения

ArgumentNullException

function имеет значение null.

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.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>

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

function имеет значение null.

Примеры

В следующем примере используются две задачи для вычисления последовательности Fibonacci, заканчивающейся на F100 = F100-1 + F100-2 с начальными значениями F1= 1, F2 = 1 и F1 = 0, F2= 1. Примерно в половине времени маркер отмены задается в качестве выполнения операций. Выходные данные из примера показывают результат, если две задачи успешно завершены и если маркер отменен.

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.

Начиная с версии платформа .NET Framework 4.5, метод можно использовать Task.Run<TResult>(Func<TResult>, CancellationToken) как быстрый способ вызова StartNew<TResult>(Func<TResult>, CancellationToken) с параметрами по умолчанию. Однако обратите внимание, что между двумя методами существует разница в поведении: Task.Run<TResult>(Func<TResult>, CancellationToken) по умолчанию дочерние задачи, запущенные с TaskCreationOptions.AttachedToParent возможностью присоединения к текущему Task<TResult> экземпляру, в то время как StartNew<TResult>(Func<TResult>, CancellationToken) это делает. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.StartNew в блоге о параллельном программировании с помощью .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>

Запущенная задача.

Исключения

ArgumentNullException

function имеет значение null.

ArgumentOutOfRangeException

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.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>

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

function имеет значение null.

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.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>

Запущенная задача.

Исключения

ArgumentNullException

function имеет значение null.

ArgumentOutOfRangeException

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.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>

Запущенная задача.

Исключения

ObjectDisposedException

Предоставленный объект CancellationToken уже удален.

ArgumentNullException

function имеет значение null.

-или- scheduler имеет значение null.

ArgumentOutOfRangeException

Начиная с версии платформа .NET Framework 4.5 можно использовать Run метод с Action объектом в качестве быстрого способа вызова StartNew с параметрами по умолчанию. Дополнительные сведения и примеры кода см. в записи Task.Run и Task.Factory.StartNew в блоге о параллельном программировании с помощью .NET.

См. также раздел

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

Бөлісу құралы:

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)

Параметры типа

Параметры

Возвращаемое значение

Исключения

Комментарии

См. также раздел

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

StartNew<TResult>(Func<TResult>)

Параметры типа

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии