TaskFactory.StartNew Yöntem

Başvuru

Tanım

Ad Alanı:: System.Threading.Tasks

Bütünleştirilmiş Kod:: System.Threading.Tasks.dll

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bir görev oluşturur ve başlatır.

Aşırı Yüklemeler

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Belirtilen eylem temsilcisi, durum, iptal belirteci, oluşturma seçenekleri ve görev zamanlayıcı için bir görev oluşturur ve başlatır.
StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)	Belirtilen eylem temsilcisi, iptal belirteci, oluşturma seçenekleri ve durum için bir görev oluşturur ve başlatır.
StartNew(Action<Object>, Object, TaskCreationOptions)	Belirtilen eylem temsilcisi, durum ve oluşturma seçenekleri için bir görev oluşturur ve başlatır.
StartNew(Action<Object>, Object, CancellationToken)	Belirtilen eylem temsilcisi, durum ve iptal belirteci için bir görev oluşturur ve başlatır.
StartNew(Action, CancellationToken)	Belirtilen eylem temsilcisi ve iptal belirteci için bir görev oluşturur ve başlatır.
StartNew(Action, TaskCreationOptions)	Belirtilen eylem temsilcisi ve oluşturma seçenekleri için bir görev oluşturur ve başlatır.
StartNew(Action)	Belirtilen eylem temsilcisi için bir görev oluşturur ve başlatır.
StartNew(Action<Object>, Object)	Belirtilen eylem temsilcisi ve durumu için bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Belirtilen işlev temsilcisi, iptal belirteci, oluşturma seçenekleri ve görev zamanlayıcı için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<TResult>)	Belirtilen işlev temsilcisi için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<Object,TResult>, Object)	Belirtilen işlev temsilcisi ve durumu için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<TResult>, CancellationToken)	Belirtilen işlev temsilcisi ve iptal belirteci için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<TResult>, TaskCreationOptions)	Belirtilen işlev temsilcisi ve oluşturma seçenekleri için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken)	Belirtilen işlev temsilcisi, durum ve iptal belirteci için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)	Belirtilen işlev temsilcisi, durum ve oluşturma seçenekleri için türünde `TResult` bir görev oluşturur ve başlatır.
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Belirtilen işlev temsilcisi, durum, iptal belirteci, oluşturma seçenekleri ve görev zamanlayıcı için türünde `TResult` bir görev oluşturur ve başlatır.

Açıklamalar

.NET Framework 4.5'den başlayarak, Task.Run işlem bağlı bir görevi başlatmanın önerilen yolu yöntemidir. StartNew Yöntemini yalnızca uzun süre çalışan, işlemle ilişkili bir görev için ayrıntılı denetime ihtiyacınız olduğunda kullanın. Bu, aşağıdakileri denetlemek istediğiniz senaryoları içerir:

Görev oluşturma seçenekleri. Yöntemi tarafından Task.Run varsayılan olarak oluşturulan görevler seçeneğiyle TaskCreationOptions.DenyChildAttach oluşturulur. Bu davranışı geçersiz kılmak veya başka TaskCreationOptions seçenekler sağlamak için bir StartNew aşırı yükleme çağrısı yapın.
Parametre geçirme. yönteminin Task.Run aşırı yüklemeleri, görev temsilcisine parametre geçirmenize izin vermez. yönteminin StartNew aşırı yüklemeleri yapar.
Görev zamanlayıcı. yönteminin Task.Run aşırı yüklemeleri varsayılan görev zamanlayıcısını kullanır. Görev zamanlayıcısını denetlemek için parametresiyle scheduler bir StartNew aşırı yükleme çağırın. Daha fazla bilgi için bkz. TaskScheduler.

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

Belirtilen eylem temsilcisi, durum, iptal belirteci, oluşturma seçenekleri ve görev zamanlayıcı için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action<Object>

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

state: Object

Temsilci tarafından action kullanılacak verileri içeren nesne.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

scheduler: TaskScheduler

Oluşturulan görevi zamanlamak için kullanılan görev zamanlayıcı.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlanan CancellationToken zaten atılmış.

ArgumentNullException

action, null değeridir.

-veya-

scheduler, null değeridir.

ArgumentOutOfRangeException

creationOptions bağımsız değişkeni geçersiz TaskCreationOptions bir değer belirtir. Daha fazla bilgi için bkz. Açıklamalar: FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak bir Görev oluşturmaya ve ardından yürütme için zamanlamak üzere çağırmaya Start eşdeğerdir.

.NET Framework 4.5'den başlayarak, varsayılan parametrelerle çağırmanın Run StartNew hızlı bir yolu olarak yöntemini bir Action nesnesiyle kullanabilirsiniz. Daha fazla bilgi ve kod örnekleri için .NET ile Paralel Programlama blogunda Task.Run vs Task.Factory.StartYeni bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

Belirtilen eylem temsilcisi, iptal belirteci, oluşturma seçenekleri ve durum için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

scheduler: TaskScheduler

Oluşturulan görevi zamanlamak için kullanılan görev zamanlayıcı.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlanan CancellationToken zaten atılmış.

ArgumentNullException

action, null değeridir.

-veya- scheduler, null değeridir.

ArgumentOutOfRangeException

creationOptions geçersiz bir TaskCreationOptions değeri belirtir. Daha fazla bilgi için bkz. Açıklamalar: FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak bir Görev oluşturmaya ve ardından yürütme için zamanlamak üzere çağırmaya Start eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action<Object>, Object, TaskCreationOptions)

Belirtilen eylem temsilcisi, durum ve oluşturma seçenekleri için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action<Object>

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

state: Object

Temsilci tarafından action kullanılacak verileri içeren nesne.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ArgumentNullException

action, null değeridir.

ArgumentOutOfRangeException

creationOptions geçersiz TaskCreationOptions bir değer belirtir.

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak bir Görev oluşturmaya ve ardından yürütme için zamanlamak üzere çağırmaya Start eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action<Object>, Object, CancellationToken)

Belirtilen eylem temsilcisi, durum ve iptal belirteci için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action<Object>

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

state: Object

Temsilci tarafından action kullanılacak verileri içeren bir nesne.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlanan CancellationToken zaten atılmış.

ArgumentNullException

action, null değeridir.

Örnekler

Aşağıdaki örnek, 6 harfli sözcüklerden oluşan bir dizi tanımlar. Daha sonra her sözcük bir Action<T> temsilciye geçirilir ve bu da sözcüğü karıştırarak özgün sözcüğü ve karışık sürümünü görüntüler.

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

Örneğin, bir kilit tarafından korunan tek bir rastgele sayı oluşturucuyu başlatdığını unutmayın. Kilit gereksinimi için sınıf konusunun "The System.Random sınıfı ve iş parçacığı güvenliği" Random bölümüne bakın. Rastgele sayı oluşturucunun bozulma olasılığını işlemek için göreve bir iptal belirteci geçirilir. İki rastgele sayı sıfıra eşitse, yöntem rastgele sayı oluşturucunun bozuk olduğunu varsayar ve iptal belirtecini ayarlar. Bir sözcükteki chars altı karakteri içeren diziyi sıralamadan önce yöntem, belirteç iptal edildiyse oluşturmak OperationCanceledException için yöntemini çağırırCancellationToken.ThrowIfCancellationRequested.

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak bir Görev oluşturmaya ve ardından yürütme için zamanlamak üzere çağırmaya Start eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action, CancellationToken)

Belirtilen eylem temsilcisi ve iptal belirteci için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlananlar CancellationToken zaten atılmış.

ArgumentNullException

action, null değeridir.

Örnekler

Aşağıdaki örnek, C:\Windows\System32 dizinindeki dosyaları yineleyen bir görev oluşturmak için yöntemini çağırırStartNew(Action, CancellationToken). Lambda ifadesi, bir List<T> nesneye her dosya hakkında bilgi eklemek için yöntemini çağırırParallel.ForEach. Döngü tarafından Parallel.ForEach çağrılan her ayrılmış iç içe görev, iptal belirtecinin durumunu denetler ve iptal istenirse yöntemini çağırır CancellationToken.ThrowIfCancellationRequested . yöntemi, CancellationToken.ThrowIfCancellationRequested çağıran iş parçacığı yöntemini çağırdığında Task.Wait bir blokta işlenen bir catch özel durum oluştururOperationCanceledException.

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

Açıklamalar

Çağırma StartNew işlevi, oluşturucularından birini kullanarak bir Görev oluşturmaya ve ardından yürütme için zamanlamak üzere çağırmaya Start eşdeğerdir.

.NET Framework 4.5'den başlayarak, varsayılan parametrelerle çağırmanın Task.Run(Action, CancellationToken) StartNew(Action, CancellationToken) hızlı bir yolu olarak yöntemini kullanabilirsiniz. Bununla birlikte, ile ilgili iki yöntem arasında davranış farkı olduğuna dikkat edin: Task.Run(Action, CancellationToken) varsayılan olarak alt görevlerin TaskCreationOptions.AttachedToParent geçerli Task örneğe ekleme seçeneğiyle başlatılmasına izin vermez, ancak StartNew(Action, CancellationToken) bunu yapar. Daha fazla bilgi ve kod örnekleri için .NET ile Paralel Programlama blogunda Task.Run vs Task.Factory.StartNew bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action, TaskCreationOptions)

Belirtilen eylem temsilcisi ve oluşturma seçenekleri için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ArgumentNullException

action, null değeridir.

ArgumentOutOfRangeException

creationOptions geçersiz TaskCreationOptions bir değer belirtir.

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak bir Görev oluşturmaya ve ardından yürütme için zamanlamak üzere çağırmaya Start eşdeğerdir.

.NET Framework 4.5'den başlayarak, varsayılan parametrelerle çağırmanın Run StartNew hızlı bir yolu olarak yöntemini bir Action nesneyle kullanabilirsiniz. Daha fazla bilgi ve kod örnekleri için .NET ile Paralel Programlama blogunda Task.Run vs Task.Factory.StartNew bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action)

Belirtilen eylem temsilcisi için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ArgumentNullException

bağımsız action değişkenidir null.

Örnekler

Aşağıdaki örnek, rastgele bir sayı oluşturan, Action bunu Unicode kod noktası olarak yorumlayan, UTF16 kodlu bir kod birimine dönüştüren ve sonuçta elde edilen karakter veya karakterler hakkındaki bilgileri görüntüleyen bir temsilciyi tekrar tekrar çağırmak için yöntemini kullanırStartNew(Action).

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

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      List<Task> tasks  = new List<Task>();
      // Execute the task 10 times.
      for (int ctr = 1; ctr <= 9; ctr++) {
         tasks.Add(Task.Factory.StartNew( () => {
                                            int utf32 = 0;
                                            lock(rnd) {
                                               // Get UTF32 value.
                                               utf32 = rnd.Next(0, 0xE01F0);
                                            }
                                            // Convert it to a UTF16-encoded character.
                                            string utf16 = Char.ConvertFromUtf32(utf32);
                                            // Display information about the character.
                                            Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})", 
                                                              utf32, utf16, ShowHex(utf16));
                                         }));                           
      }
      Task.WaitAll(tasks.ToArray()); 
   }

   private static string ShowHex(string value)
   {
      string hexString = null;
      // Handle only non-control characters.
      if (! Char.IsControl(value, 0)) {
         foreach (var ch in value)
            hexString += $"0x{(ushort)ch:X} ";
      }   
      return hexString.Trim();
   }
}
// The example displays the following output:
//       0x00097103 --> '򗄃' (0x55836 0x56579)
//       0x000A98A1 --> '򩢡' (0x55910 0x56481)
//       0x00050002 --> '񐀂' (0x55552 0x56322)
//       0x0000FEF1 --> 'ﻱ' (0x65265)
//       0x0008BC0A --> '򋰊' (0x55791 0x56330)
//       0x000860EA --> '򆃪' (0x55768 0x56554)
//       0x0009AC5A --> '򚱚' (0x55851 0x56410)
//       0x00053320 --> '񓌠' (0x55564 0x57120)
//       0x000874EF --> '򇓯' (0x55773 0x56559)

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

Public Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks As New List(Of Task)
      ' Execute the task 10 times.
      For ctr As Integer = 1 To 9
         tasks.Add(Task.Factory.StartNew(Sub()
                                            Dim utf32 As Integer
                                            SyncLock(rnd)
                                               ' Get UTF32 value.
                                               utf32 = rnd.Next(0, &hE01F0)
                                            End SyncLock
                                            ' Convert it to a UTF16-encoded character.
                                            Dim utf16 As String = Char.ConvertFromUtf32(utf32)
                                            ' Display information about the character.
                                            Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})", 
                                                              utf32, utf16, ShowHex(utf16))
                                         End Sub))                           
      Next
      Task.WaitAll(tasks.ToArray()) 
   End Sub
   
   Private Function ShowHex(value As String) As String
      Dim hexString As String = Nothing
      ' Handle only non-control characters.
      If Not Char.IsControl(value, 0) Then
         For Each ch In value
            hexString += String.Format("0x{0} ", Convert.ToUInt16(ch))
         Next
      End If   
      Return hexString.Trim()
   End Function
End Module
' The example displays output similar to the following:
'       0x00097103 --> '򗄃' (0x55836 0x56579)
'       0x000A98A1 --> '򩢡' (0x55910 0x56481)
'       0x00050002 --> '񐀂' (0x55552 0x56322)
'       0x0000FEF1 --> 'ﻱ' (0x65265)
'       0x0008BC0A --> '򋰊' (0x55791 0x56330)
'       0x000860EA --> '򆃪' (0x55768 0x56554)
'       0x0009AC5A --> '򚱚' (0x55851 0x56410)
'       0x00053320 --> '񓌠' (0x55564 0x57120)
'       0x000874EF --> '򇓯' (0x55773 0x56559)

Açıklamalar

Çağırma StartNew işlevi, oluşturucularından birini kullanarak görev oluşturmaya ve ardından görevi yürütmeye zamanlamak için yöntemini çağırmaya Task.Start eşdeğerdir.

.NET Framework 4.5'den başlayarak, varsayılan parametrelerle çağırmanın Task.Run(Action) StartNew(Action) hızlı bir yolu olarak yöntemini kullanabilirsiniz. Bununla birlikte, ile ilgili iki yöntem arasında davranış farkı olduğuna dikkat edin: Task.Run(Action) varsayılan olarak alt görevlerin TaskCreationOptions.AttachedToParent geçerli Task örneğe ekleme seçeneğiyle başlatılmasına izin vermez, ancak StartNew(Action) bunu yapar. Daha fazla bilgi ve kod örnekleri için .NET ile Paralel Programlama blogunda Task.Run vs Task.Factory.StartNew bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

StartNew(Action<Object>, Object)

Belirtilen eylem temsilcisi ve durumu için bir görev oluşturur ve başlatır.

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

Parametreler

action: Action<Object>

Zaman uyumsuz olarak yürütülecek eylem temsilcisi.

state: Object

Temsilci tarafından action kullanılacak verileri içeren bir nesne.

Döndürülenler

Task

Başlatılan görev.

Özel durumlar

ArgumentNullException

bağımsız action değişkenidir null.

Örnekler

Aşağıdaki örnek, 6 harfli sözcüklerden oluşan bir dizi tanımlar. Ardından her sözcük bir Action<T> temsilciye geçirilir ve bu da sözcüğü karıştırarak özgün sözcüğü ve karışık sürümünü görüntüler.

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

Örneğin, bir kilit tarafından korunan tek bir rastgele sayı oluşturucuyu başlatdığını unutmayın. Kilit gereksinimi için sınıf konusunun "System.Random sınıfı ve iş parçacığı güvenliği" konusuna Random bakın.

Açıklamalar

çağırma StartNew işlevi, oluşturucularından birini kullanarak bir Task oluşturma ve ardından yürütme için zamanlamak üzere yöntemini çağırma Start ile eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi, iptal belirteci, oluşturma seçenekleri ve görev zamanlayıcı için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

scheduler: TaskScheduler

Oluşturulan görevi zamanlamak için kullanılan görev zamanlayıcı.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlananlar CancellationToken zaten atılmış.

ArgumentNullException

function, null değeridir.

-veya- scheduler, null değeridir.

ArgumentOutOfRangeException

creationOptions geçersiz TaskCreationOptions bir değer belirtir. Daha fazla bilgi için bkz. Açıklamalar: FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak oluşturma Task<TResult> ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

StartNew<TResult>(Func<TResult>)

Belirtilen işlev temsilcisi için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ArgumentNullException

function bağımsız değişkenidirnull.

Örnekler

Aşağıdaki örnek, iki rastgele sayı oluşturan ve kullanıcıdan toplamını girmesini isteyen basit bir ekleme uygulamasıdır. Ardından yanıtın doğru olup olmadığını gösterir veya kullanıcının yanıtı geçerli bir sayı değilse, kullanıcıdan geçerli bir sayıyı yeniden girmesini ister. StartNew, eklenecek rastgele sayıları döndüren nesneleri oluşturmak Task<TResult> için kullanılır.

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

Açıklamalar

Çağırma StartNew işlevi, oluşturucularından birini kullanarak bir Task<TResult> oluşturma ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

.NET Framework 4.5'den başlayarak, varsayılan parametrelerle çağırmanın Task.Run<TResult>(Func<TResult>) hızlı bir yolu olarak yöntemini çağırabilirsinizStartNew. Bununla birlikte, ile ilgili iki yöntem arasında davranış farkı olduğunu unutmayın: Task.Run<TResult>(Func<TResult>) varsayılan olarak, geçerli Task<TResult> örneğe ekleme seçeneğiyle TaskCreationOptions.AttachedToParent başlatılan alt görevlere izin vermez, ancak StartNew<TResult>(Func<TResult>) bunu yapar. Daha fazla bilgi ve kod örnekleri için .NET ile Paralel Programlama blogunda Task.Run ve Task.Factory.StartNew girişlerine bakın.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi ve durumu için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<Object,TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

state: Object

Temsilci tarafından function kullanılacak verileri içeren nesne.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ArgumentNullException

function, null değeridir.

Açıklamalar

StartNew çağrısı, oluşturucularından birini kullanarak oluşturma Task<TResult> ve ardından yürütme için zamanlamak üzere çağırma ile Start işlevsel olarak eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi ve iptal belirteci için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlananlar CancellationToken zaten atılmış.

ArgumentNullException

function, null değeridir.

Örnekler

Aşağıdaki örnek, F100 = F100-1 + F100-2 ile biten Fibonacci dizisini F1= 1, F2 = 1 ve F1 = 0, F2= 1 tohum değerleriyle hesaplamak için iki görev kullanır. İşlemler yürütülürken yaklaşık yarısı bir iptal belirteci ayarlanır. Örnekten elde edilen çıktı, iki görev başarıyla tamamlanırsa ve belirteç iptal edilirse sonucu gösterir.

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.

Açıklamalar

Çağırma StartNew işlevi, oluşturucularından birini kullanarak bir Task<TResult> oluşturma ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

.NET Framework 4.5'den başlayarak, varsayılan parametrelerle çağırmanın Task.Run<TResult>(Func<TResult>, CancellationToken) StartNew<TResult>(Func<TResult>, CancellationToken) hızlı bir yolu olarak yöntemini kullanabilirsiniz. Bununla birlikte, ile ilgili iki yöntem arasında davranış farkı olduğunu unutmayın: Task.Run<TResult>(Func<TResult>, CancellationToken) varsayılan olarak, geçerli Task<TResult> örneğe ekleme seçeneğiyle TaskCreationOptions.AttachedToParent başlatılan alt görevlere izin vermez, ancak StartNew<TResult>(Func<TResult>, CancellationToken) bunu yapar. Daha fazla bilgi ve kod örnekleri için .NET ile Paralel Programlama blogunda Task.Run ve Task.Factory.StartNew girişlerine bakın.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi ve oluşturma seçenekleri için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ArgumentNullException

function, null değeridir.

ArgumentOutOfRangeException

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak oluşturma Task<TResult> ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi, durum ve iptal belirteci için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<Object,TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

state: Object

Temsilci tarafından function kullanılacak verileri içeren bir nesne.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlananlar CancellationToken zaten atılmış.

ArgumentNullException

function, null değeridir.

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak oluşturma Task<TResult> ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi, durum ve oluşturma seçenekleri için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<Object,TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

state: Object

Temsilci tarafından function kullanılacak verileri içeren bir nesne.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ArgumentNullException

function, null değeridir.

ArgumentOutOfRangeException

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak oluşturma Task<TResult> ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır

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

Belirtilen işlev temsilcisi, durum, iptal belirteci, oluşturma seçenekleri ve görev zamanlayıcı için türünde TResult bir görev oluşturur ve başlatır.

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)

Tür Parametreleri

TResult

Görev aracılığıyla kullanılabilen sonucun türü.

Parametreler

function: Func<Object,TResult>

Görev aracılığıyla kullanılabilir olacak gelecekteki sonucu döndüren bir işlev temsilcisi.

state: Object

Temsilci tarafından function kullanılacak verileri içeren bir nesne.

cancellationToken: CancellationToken

Yeni göreve atanacak iptal belirteci.

creationOptions: TaskCreationOptions

Oluşturulan görevin davranışını denetleen numaralandırma değerlerinden biri.

scheduler: TaskScheduler

Oluşturulan görevi zamanlamak için kullanılan görev zamanlayıcı.

Döndürülenler

Task<TResult>

Başlatılan görev.

Özel durumlar

ObjectDisposedException

Sağlananlar CancellationToken zaten atılmış.

ArgumentNullException

function, null değeridir.

-veya- scheduler, null değeridir.

ArgumentOutOfRangeException

Açıklamalar

StartNew çağrısı işlevi, oluşturucularından birini kullanarak oluşturma Task<TResult> ve ardından yürütme için zamanlamak üzere çağırma Start ile eşdeğerdir.

Ayrıca bkz.

Şunlara uygulanır