TaskFactory.StartNew Metode

Definisi

Ruang nama:: System.Threading.Tasks

Rakitan:: mscorlib.dll, System.Threading.Tasks.dll

Rakitan:: netstandard.dll, System.Runtime.dll

Rakitan:: System.Threading.Tasks.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat dan memulai tugas.

Overload

Nama	Deskripsi
StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Membuat dan memulai tugas untuk delegasi tindakan, status, token pembatalan, opsi pembuatan, dan penjadwal tugas yang ditentukan.
StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)	Membuat dan memulai tugas untuk delegasi tindakan, token pembatalan, opsi pembuatan, dan status yang ditentukan.
StartNew(Action<Object>, Object, TaskCreationOptions)	Membuat dan memulai tugas untuk delegasi tindakan, status, dan opsi pembuatan yang ditentukan.
StartNew(Action<Object>, Object, CancellationToken)	Membuat dan memulai tugas untuk delegasi tindakan, status, dan token pembatalan yang ditentukan.
StartNew(Action, CancellationToken)	Membuat dan memulai tugas untuk delegasi tindakan dan token pembatalan yang ditentukan.
StartNew(Action, TaskCreationOptions)	Membuat dan memulai tugas untuk delegasi tindakan dan opsi pembuatan yang ditentukan.
StartNew(Action)	Membuat dan memulai tugas untuk delegasi tindakan yang ditentukan.
StartNew(Action<Object>, Object)	Membuat dan memulai tugas untuk delegasi dan status tindakan yang ditentukan.
StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi yang ditentukan, token pembatalan, opsi pembuatan, dan penjadwal tugas.
StartNew<TResult>(Func<TResult>)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi yang ditentukan.
StartNew<TResult>(Func<Object,TResult>, Object)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi dan status yang ditentukan.
StartNew<TResult>(Func<TResult>, CancellationToken)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi dan token pembatalan yang ditentukan.
StartNew<TResult>(Func<TResult>, TaskCreationOptions)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi dan opsi pembuatan yang ditentukan.
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi, status, dan token pembatalan yang ditentukan.
StartNew<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi, status, dan opsi pembuatan yang ditentukan.
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Membuat dan memulai tugas jenis `TResult` untuk delegasi fungsi, status, token pembatalan, opsi pembuatan, dan penjadwal tugas yang ditentukan.

Keterangan

Dimulai dengan .NET Framework 4.5, metode Task.Run adalah cara yang direkomendasikan untuk meluncurkan tugas yang terikat komputasi. StartNew Gunakan metode hanya ketika Anda memerlukan kontrol terperintah untuk tugas yang terikat komputasi yang berjalan lama. Ini termasuk skenario di mana Anda ingin mengontrol hal berikut:

Opsi pembuatan tugas. Tugas yang dibuat oleh Task.Run metode secara default dibuat dengan TaskCreationOptions.DenyChildAttach opsi . Untuk mengambil alih perilaku ini, atau untuk menyediakan opsi lain TaskCreationOptions , panggil StartNew kelebihan beban.
Parameter lolos. Kelebihan beban Task.Run metode tidak memungkinkan Anda meneruskan parameter ke delegasi tugas. Kelebihan beban StartNew metode dilakukan.
Penjadwal tugas. Kelebihan beban Task.Run metode menggunakan penjadwal tugas default. Untuk mengontrol penjadwal tugas, panggil StartNew kelebihan beban dengan scheduler parameter. Untuk informasi selengkapnya, lihat TaskScheduler .

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan, status, token pembatalan, opsi pembuatan, dan penjadwal tugas yang ditentukan.

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

Parameter

action: Action<Object>

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

state: Object

Objek yang berisi data yang akan digunakan oleh action delegasi.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

scheduler: TaskScheduler

Penjadwal tugas yang digunakan untuk menjadwalkan tugas yang dibuat.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

action adalah null.

-atau-

scheduler adalah null.

ArgumentOutOfRangeException

creationOptions argumen menentukan nilai yang tidak valid TaskCreationOptions . Untuk informasi selengkapnya, lihat Keterangan untuk FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Tugas menggunakan salah satu konstruktornya lalu memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat Task.Run vs Task.Factory.StartNew di Blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan, token pembatalan, opsi pembuatan, dan status yang ditentukan.

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

Parameter

action: Action

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

scheduler: TaskScheduler

Penjadwal tugas yang digunakan untuk menjadwalkan tugas yang dibuat.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

action adalah null.

-atau-

scheduler adalah null.

ArgumentOutOfRangeException

creationOptions menentukan nilai TaskCreationOptions yang tidak valid. Untuk informasi selengkapnya, lihat Keterangan untuk FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Tugas menggunakan salah satu konstruktornya lalu memanggil untuk menjadwalkannya Start untuk dieksekusi.

Lihat juga

Berlaku untuk

StartNew(Action<Object>, Object, TaskCreationOptions)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan, status, dan opsi pembuatan yang ditentukan.

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

Parameter

action: Action<Object>

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

state: Object

Objek yang berisi data yang akan digunakan oleh action delegasi.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ArgumentNullException

action adalah null.

ArgumentOutOfRangeException

creationOptions menentukan nilai yang tidak valid TaskCreationOptions .

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Tugas menggunakan salah satu konstruktornya lalu memanggil untuk menjadwalkannya Start untuk dieksekusi.

Lihat juga

Berlaku untuk

StartNew(Action<Object>, Object, CancellationToken)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan, status, dan token pembatalan yang ditentukan.

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

Parameter

action: Action<Object>

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

state: Object

Objek yang berisi data yang akan digunakan oleh action delegasi.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

action adalah null.

Contoh

Contoh berikut mendefinisikan array kata 6 huruf. Setiap kata kemudian diteruskan ke Action<T> delegasi, yang mengacak kata dan menampilkan kata asli dan versi orisinalnya.

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

Perhatikan bahwa contoh menginisialisasi generator angka acak tunggal, yang dilindungi oleh kunci. Untuk kebutuhan kunci, lihat "Kelas System.Random dan keamanan utas" dalam Random topik kelas. Untuk menangani kemungkinan kerusakan generator angka acak, token pembatalan diteruskan ke tugas. Jika dua angka acak sama dengan nol, metode mengasumsikan bahwa generator angka acak rusak dan mengatur token pembatalan. Sebelum mengurutkan chars array yang berisi enam karakter dalam sebuah kata, metode memanggil CancellationToken.ThrowIfCancellationRequested metode untuk melemparkan OperationCanceledException jika token telah dibatalkan.

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Tugas menggunakan salah satu konstruktornya lalu memanggil untuk menjadwalkannya Start untuk dieksekusi.

Lihat juga

Berlaku untuk

StartNew(Action, CancellationToken)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan dan token pembatalan yang ditentukan.

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

Parameter

action: Action

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

action adalah null.

Contoh

Contoh berikut memanggil StartNew(Action, CancellationToken) metode untuk membuat tugas yang mengurutkan file di direktori C:\Windows\System32. Ekspresi lambda memanggil Parallel.ForEach metode untuk menambahkan informasi tentang setiap file ke List<T> objek. Setiap tugas berlapis yang dilepas yang dipanggil oleh Parallel.ForEach perulangan memeriksa status token pembatalan dan, jika pembatalan diminta, memanggil CancellationToken.ThrowIfCancellationRequested metode . Metode ini CancellationToken.ThrowIfCancellationRequested melemparkan OperationCanceledException pengecualian yang ditangani dalam catch blok ketika utas Task.Wait panggilan memanggil metode .

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

Keterangan

StartNew Panggilan secara fungsional setara dengan membuat Tugas menggunakan salah satu konstruktornya lalu memanggil untuk menjadwalkannya Start untuk eksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Task.Run(Action, CancellationToken) sebagai cara cepat untuk memanggil StartNew(Action, CancellationToken) dengan parameter default. Namun, perhatikan bahwa ada perbedaan perilaku antara dua metode mengenai : Task.Run(Action, CancellationToken) secara default tidak memungkinkan tugas anak dimulai dengan TaskCreationOptions.AttachedToParent opsi untuk melampirkan ke instans saat ini Task , sedangkan StartNew(Action, CancellationToken) tidak. Untuk informasi selengkapnya dan contoh kode, lihat Task.Run vs Task.Factory.StartNew di Blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

StartNew(Action, TaskCreationOptions)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan dan opsi pembuatan yang ditentukan.

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

Parameter

action: Action

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ArgumentNullException

action adalah null.

ArgumentOutOfRangeException

creationOptions menentukan nilai yang tidak valid TaskCreationOptions .

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Tugas menggunakan salah satu konstruktornya lalu memanggil untuk menjadwalkannya Start untuk dieksekusi.

Lihat juga

Berlaku untuk

StartNew(Action)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi tindakan yang ditentukan.

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

Parameter

action: Action

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ArgumentNullException

Argumennya action adalah null.

Contoh

Contoh berikut menggunakan StartNew(Action) metode untuk berulang kali memanggil Action delegasi yang menghasilkan angka acak, menafsirkannya sebagai titik kode Unicode, mengonversinya ke unit kode yang dikodekan UTF16, dan menampilkan informasi tentang karakter atau karakter yang dihasilkan.

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)

Keterangan

StartNew Panggilan secara fungsional setara dengan membuat tugas dengan menggunakan salah satu konstruktornya, lalu memanggil metode untuk menjadwalkan Task.Start tugas untuk eksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Task.Run(Action) sebagai cara cepat untuk memanggil StartNew(Action) dengan parameter default. Namun, perhatikan bahwa ada perbedaan perilaku antara dua metode mengenai : Task.Run(Action) secara default tidak memungkinkan tugas anak dimulai dengan TaskCreationOptions.AttachedToParent opsi untuk melampirkan ke instans saat ini Task , sedangkan StartNew(Action) tidak. Untuk informasi selengkapnya dan contoh kode, lihat Task.Run vs Task.Factory.StartNew di Blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

StartNew(Action<Object>, Object)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas untuk delegasi dan status tindakan yang ditentukan.

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

Parameter

action: Action<Object>

Tindakan mendelegasikan untuk mengeksekusi secara asinkron.

state: Object

Objek yang berisi data yang akan digunakan oleh action delegasi.

Mengembalikan

Task

Tugas yang dimulai.

Pengecualian

ArgumentNullException

Argumennya action adalah null.

Contoh

Contoh berikut mendefinisikan array kata 6 huruf. Setiap kata kemudian diteruskan ke Action<T> delegasi, yang mengacak kata dan menampilkan kata asli dan versi orisinalnya.

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

Perhatikan bahwa contoh menginisialisasi generator angka acak tunggal, yang dilindungi oleh kunci. Untuk kebutuhan kunci, lihat "Kelas System.Random dan keamanan utas" dalam Random topik kelas.

Keterangan

StartNew Panggilan secara fungsional setara dengan membuat Task menggunakan salah satu konstruktornya dan kemudian memanggil metode untuk menjadwalkannya Start untuk eksekusi.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi yang ditentukan, token pembatalan, opsi pembuatan, dan penjadwal tugas.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

scheduler: TaskScheduler

Penjadwal tugas yang digunakan untuk menjadwalkan tugas yang dibuat.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

function adalah null.

-atau-

scheduler adalah null.

ArgumentOutOfRangeException

creationOptions menentukan nilai yang tidak valid TaskCreationOptions . Untuk informasi selengkapnya, lihat Keterangan untuk FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

StartNew<TResult>(Func<TResult>)

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ArgumentNullException

Argumennya function adalah null.

Contoh

Contoh berikut adalah aplikasi penambahan sederhana yang menghasilkan dua angka acak dan meminta pengguna untuk memasukkan jumlah mereka. Kemudian menunjukkan apakah jawabannya benar atau, jika respons pengguna bukan angka yang valid, meminta pengguna untuk memasukkan kembali nomor yang valid. StartNew digunakan untuk membuat Task<TResult> objek yang mengembalikan angka acak untuk ditambahkan.

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

Keterangan

StartNew Panggilan secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat memanggil metode Task.Run<TResult>(Func<TResult>) sebagai cara cepat untuk memanggil StartNew dengan parameter default. Namun, perhatikan bahwa ada perbedaan perilaku antara dua metode mengenai : Task.Run<TResult>(Func<TResult>) secara default tidak memungkinkan tugas anak dimulai dengan TaskCreationOptions.AttachedToParent opsi untuk melampirkan ke instans saat ini Task<TResult> , sedangkan StartNew<TResult>(Func<TResult>) tidak. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi dan status yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<Object,TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

state: Object

Objek yang berisi data yang akan digunakan oleh function delegasi.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ArgumentNullException

function adalah null.

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi dan token pembatalan yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

function adalah null.

Contoh

Contoh berikut menggunakan dua tugas untuk menghitung urutan Fibonacci yang berakhiran F100 = F100-1 + F100-2 dengan nilai benih F1= 1, F2 = 1 dan F1 = 0, F2= 1. Sekitar setengah dari waktu, token pembatalan ditetapkan sebagai operasi yang dijalankan. Output dari contoh menunjukkan hasil jika dua tugas berhasil diselesaikan dan jika token dibatalkan.

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.

Keterangan

StartNew Panggilan secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Task.Run<TResult>(Func<TResult>, CancellationToken) sebagai cara cepat untuk memanggil StartNew<TResult>(Func<TResult>, CancellationToken) dengan parameter default. Namun, perhatikan bahwa ada perbedaan perilaku antara dua metode mengenai : Task.Run<TResult>(Func<TResult>, CancellationToken) secara default tidak memungkinkan tugas anak dimulai dengan TaskCreationOptions.AttachedToParent opsi untuk melampirkan ke instans saat ini Task<TResult> , sedangkan StartNew<TResult>(Func<TResult>, CancellationToken) tidak. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi dan opsi pembuatan yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ArgumentNullException

function adalah null.

ArgumentOutOfRangeException

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi, status, dan token pembatalan yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<Object,TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

state: Object

Objek yang berisi data yang akan digunakan oleh function delegasi.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

function adalah null.

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi, status, dan opsi pembuatan yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<Object,TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

state: Object

Objek yang berisi data yang akan digunakan oleh function delegasi.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ArgumentNullException

function adalah null.

ArgumentOutOfRangeException

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

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

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Sumber:: TaskFactory.cs

Membuat dan memulai tugas jenis TResult untuk delegasi fungsi, status, token pembatalan, opsi pembuatan, dan penjadwal tugas yang ditentukan.

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)

Jenis parameter

TResult

Jenis hasil yang tersedia melalui tugas.

Parameter

function: Func<Object,TResult>

Delegasi fungsi yang mengembalikan hasil di masa mendatang untuk tersedia melalui tugas.

state: Object

Objek yang berisi data yang akan digunakan oleh function delegasi.

cancellationToken: CancellationToken

Token pembatalan yang akan ditetapkan ke tugas baru.

creationOptions: TaskCreationOptions

Salah satu nilai enumerasi yang mengontrol perilaku tugas yang dibuat.

scheduler: TaskScheduler

Penjadwal tugas yang digunakan untuk menjadwalkan tugas yang dibuat.

Mengembalikan

Task<TResult>

Tugas yang dimulai.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

function adalah null.

-atau-

scheduler adalah null.

ArgumentOutOfRangeException

Keterangan

Memanggil StartNew secara fungsional setara dengan membuat Task<TResult> menggunakan salah satu konstruktornya dan kemudian memanggil untuk menjadwalkannya Start untuk dieksekusi.

Dimulai dengan .NET Framework 4.5, Anda dapat menggunakan metode Run dengan objek Action sebagai cara cepat untuk memanggil StartNew dengan parameter default. Untuk informasi selengkapnya dan contoh kode, lihat entri Task.Run vs. Task.Factory.StartNew di blog Pemrograman Paralel dengan .NET.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?