Task Konstruktor

Referensi

Definisi

Ruang nama:: System.Threading.Tasks

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.

Menginisialisasi baru Task.

Overload

Task(Action)	Menginisialisasi baru Task dengan tindakan yang ditentukan.
Task(Action, CancellationToken)	Menginisialisasi baru Task dengan tindakan yang ditentukan dan CancellationToken.
Task(Action, TaskCreationOptions)	Menginisialisasi baru Task dengan opsi tindakan dan pembuatan yang ditentukan.
Task(Action<Object>, Object)	Menginisialisasi baru Task dengan tindakan dan status yang ditentukan.
Task(Action, CancellationToken, TaskCreationOptions)	Menginisialisasi baru Task dengan opsi tindakan dan pembuatan yang ditentukan.
Task(Action<Object>, Object, CancellationToken)	Menginisialisasi baru Task dengan tindakan, status, dan CancellationToken.
Task(Action<Object>, Object, TaskCreationOptions)	Menginisialisasi baru Task dengan tindakan, status, dan opsi yang ditentukan.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Menginisialisasi baru Task dengan tindakan, status, dan opsi yang ditentukan.

Task(Action)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan tindakan yang ditentukan.

public:
 Task(Action ^ action);

public Task (Action action);

new System.Threading.Tasks.Task : Action -> System.Threading.Tasks.Task

Public Sub New (action As Action)

Parameter

action: Action

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

Pengecualian

ArgumentNullException

Argumennya action adalah null.

Contoh

Contoh berikut menggunakan Task(Action) konstruktor untuk membuat tugas yang mengambil nama file dalam direktori tertentu. Semua tugas menulis nama file ke satu ConcurrentBag<T> objek. Contoh kemudian memanggil WaitAll(Task[]) metode untuk memastikan bahwa semua tugas telah selesai, lalu menampilkan hitungan jumlah total nama file yang ditulis ke ConcurrentBag<T> objek.

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

public class Example
{
   public static async Task Main()
   {
      var list = new ConcurrentBag<string>();
      string[] dirNames = { ".", ".." };
      List<Task> tasks = new List<Task>();
      foreach (var dirName in dirNames) {
         Task t = new Task( () => { foreach(var path in Directory.GetFiles(dirName))
                                    list.Add(path); }  );
         tasks.Add(t);
         t.Start();
      }
      await Task.WhenAll(tasks.ToArray());
      foreach (Task t in tasks)
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status);
         
      Console.WriteLine("Number of files read: {0}", list.Count);
   }
}
// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

open System.Collections.Concurrent
open System.IO
open System.Threading.Tasks

let main =
    task {
        let list = ConcurrentBag<string>()
        let dirNames = [ "."; ".." ]
        let tasks = ResizeArray()

        for dirName in dirNames do
            let t =
                new Task(fun () ->
                    for path in Directory.GetFiles dirName do
                        list.Add path)

            tasks.Add t
            t.Start()

        do! tasks.ToArray() |> Task.WhenAll

        for t in tasks do
            printfn $"Task {t.Id} Status: {t.Status}"

        printfn $"Number of files read: {list.Count}"
    }

// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

Imports System.Collections.Concurrent
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim list As New ConcurrentBag(Of String)()
      Dim dirNames() As String = { ".", ".." }
      Dim tasks As New List(Of Task)()
      For Each dirName In dirNames 
         Dim t As New Task( Sub()
                               For Each path In Directory.GetFiles(dirName)
                                  list.Add(path)
                               Next
                            End Sub  )
         tasks.Add(t)
         t.Start()
      Next
      Task.WaitAll(tasks.ToArray())
      For Each t In tasks
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status)
      Next   
      Console.WriteLine("Number of files read: {0}", list.Count)
   End Sub
End Module
' The example displays output like the following:
'       Task 1 Status: RanToCompletion
'       Task 2 Status: RanToCompletion
'       Number of files read: 23

Contoh berikut identik, kecuali menggunakan Run(Action) metode untuk membuat instans dan menjalankan tugas dalam satu operasi. Metode mengembalikan Task objek yang mewakili tugas.

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

public class Example
{
   public static void Main()
   {
      var list = new ConcurrentBag<string>();
      string[] dirNames = { ".", ".." };
      List<Task> tasks = new List<Task>();
      foreach (var dirName in dirNames) {
         Task t = Task.Run( () => { foreach(var path in Directory.GetFiles(dirName)) 
                                       list.Add(path); }  );
         tasks.Add(t);
      }
      Task.WaitAll(tasks.ToArray());
      foreach (Task t in tasks)
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status);
         
      Console.WriteLine("Number of files read: {0}", list.Count);
   }
}
// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

open System.Collections.Concurrent
open System.IO
open System.Threading.Tasks

let list = ConcurrentBag<string>()
let dirNames = [ "."; ".." ]
let tasks = ResizeArray()

for dirName in dirNames do
    let t =
        Task.Run(fun () ->
            for path in Directory.GetFiles dirName do
                list.Add path)

    tasks.Add t

tasks.ToArray() |> Task.WaitAll

for t in tasks do
    printfn $"Task {t.Id} Status: {t.Status}"

printfn $"Number of files read: {list.Count}"

// The example displays output like the following:
//       Task 1 Status: RanToCompletion
//       Task 2 Status: RanToCompletion
//       Number of files read: 23

Imports System.Collections.Concurrent
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim list As New ConcurrentBag(Of String)()
      Dim dirNames() As String = { ".", ".." }
      Dim tasks As New List(Of Task)()
      For Each dirName In dirNames 
         Dim t As Task = Task.Run( Sub()
                                      For Each path In Directory.GetFiles(dirName) 
                                         list.Add(path)
                                      Next
                                   End Sub  )
         tasks.Add(t)
      Next
      Task.WaitAll(tasks.ToArray())
      For Each t In tasks
         Console.WriteLine("Task {0} Status: {1}", t.Id, t.Status)
      Next   
      Console.WriteLine("Number of files read: {0}", list.Count)
   End Sub
End Module
' The example displays output like the following:
'       Task 1 Status: RanToCompletion
'       Task 2 Status: RanToCompletion
'       Number of files read: 23

Keterangan

Konstruktor ini hanya boleh digunakan dalam skenario lanjutan di mana diperlukan bahwa pembuatan dan awal tugas dipisahkan.

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil statis Task.Run(Action) atau TaskFactory.StartNew(Action) metode .

Jika tugas tanpa tindakan diperlukan hanya agar konsumen API memiliki sesuatu untuk ditunggu, TaskCompletionSource<TResult> harus digunakan.

Lihat juga

Run(Action)

Berlaku untuk

Task(Action, CancellationToken)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan tindakan yang ditentukan dan CancellationToken.

public:
 Task(Action ^ action, System::Threading::CancellationToken cancellationToken);

public Task (Action action, System.Threading.CancellationToken cancellationToken);

new System.Threading.Tasks.Task : Action * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Sub New (action As Action, cancellationToken As CancellationToken)

Parameter

action: Action

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

cancellationToken: CancellationToken

Tugas CancellationToken baru yang akan diamati.

Pengecualian

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

ArgumentNullException

Argumen action null.

Contoh

Contoh berikut memanggil Task(Action, CancellationToken) konstruktor untuk membuat tugas yang melakukan iterasi 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 perulangan Parallel.ForEach 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 . Metode Start ini kemudian dipanggil untuk memulai tugas.

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

public class Example
{
   public static async Task Main()
   {
      var tokenSource = new CancellationTokenSource();
      var token = tokenSource.Token;
      var files = new List<Tuple<string, string, long, DateTime>>();
      
      var t = new Task(() => { string dir = "C:\\Windows\\System32\\";
                               object obj = new Object();
                               if (Directory.Exists(dir)) {
                                  Parallel.ForEach(Directory.GetFiles(dir),
                                  f => {
                                          if (token.IsCancellationRequested)
                                             token.ThrowIfCancellationRequested();
                                          var fi = new FileInfo(f);
                                          lock(obj) {
                                             files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc));          
                                          }
                                     });
                                }
                              } , token);
      t.Start();
      tokenSource.Cancel();
      try {
         await t; 
         Console.WriteLine("Retrieved information for {0} files.", files.Count);
      }
      catch (AggregateException e) {
         Console.WriteLine("Exception messages:");
         foreach (var ie in e.InnerExceptions)
            Console.WriteLine("   {0}: {1}", ie.GetType().Name, ie.Message);

         Console.WriteLine("\nTask status: {0}", t.Status);       
      }
      finally {
         tokenSource.Dispose();
      }
   }
}
// The example displays the following output:
//       Exception messages:
//          TaskCanceledException: A task was canceled.
//       
//       Task status: Canceled

open System
open System.IO
open System.Threading
open System.Threading.Tasks

let main =
    task {
        use tokenSource = new CancellationTokenSource()
        let token = tokenSource.Token
        let files = ResizeArray()

        let t =
            new Task(
                (fun () ->
                    let dir = @"C:\Windows\System32\"
                    let obj = obj ()

                    if Directory.Exists dir then
                        Parallel.ForEach(
                            Directory.GetFiles dir,
                            fun f ->
                                if token.IsCancellationRequested then
                                    token.ThrowIfCancellationRequested()

                                let fi = FileInfo f
                                lock obj (fun () -> files.Add(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc))
                        )
                        |> ignore),
                token
            )

        t.Start()
        tokenSource.Cancel()

        try
            do! t
            printfn $"Retrieved information for {files.Count} files."

        with :? AggregateException as e ->
            printfn "Exception messages:"

            for ie in e.InnerExceptions do
                printfn $"   {ie.GetType().Name}: {ie.Message}"

            printfn $"Task status: {t.Status}"
    }

main.Wait()

// The example displays the following output:
//       Exception messages:
//          TaskCanceledException: A task was canceled.
//
//       Task status: Canceled

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

Module Example
   Public Sub Main()
      Dim tokenSource As New CancellationTokenSource()
      Dim token As CancellationToken = tokenSource.Token
      Dim files As New List(Of Tuple(Of String, String, Long, Date))()
      Dim t As New Task(Sub()
                           Dim dir As String = "C:\Windows\System32\"
                           Dim obj As New Object()
                           If Directory.Exists(dir)Then
                              Parallel.ForEach(Directory.GetFiles(dir), 
                                 Sub(f)
                                    If token.IsCancellationRequested Then
                                       token.ThrowIfCancellationRequested()
                                    End If  
                                    Dim fi As New FileInfo(f)
                                    SyncLock(obj)
                                       files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc))          
                                    End SyncLock
                                 End Sub)
                           End If
                        End Sub, token)
      t.Start()
      tokenSource.Cancel()
      Try
         t.Wait() 
         Console.WriteLine("Retrieved information for {0} files.", files.Count)
      Catch e As AggregateException
         Console.WriteLine("Exception messages:")
         For Each ie As Exception In e.InnerExceptions
            Console.WriteLine("   {0}:{1}", ie.GetType().Name, ie.Message)
         Next
         Console.WriteLine()
         Console.WriteLine("Task status: {0}", t.Status)       
      Finally
         tokenSource.Dispose()
      End Try
   End Sub
End Module
' The example displays the following output:
'       Exception messages:
'          TaskCanceledException: A task was canceled.
'       
'       Task status: Canceled

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil statis Task.Run(Action, CancellationToken) dan TaskFactory.StartNew(Action, CancellationToken) metode. Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Untuk informasi selengkapnya, lihat Paralelisme Tugas (Pustaka Paralel Tugas) dan Pembatalan di Utas Terkelola.

Berlaku untuk

Task(Action, TaskCreationOptions)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan opsi tindakan dan pembuatan yang ditentukan.

public:
 Task(Action ^ action, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action action, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action, creationOptions As TaskCreationOptions)

Parameter

action: Action

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

creationOptions: TaskCreationOptions

yang TaskCreationOptions digunakan untuk menyesuaikan perilaku tugas.

Pengecualian

ArgumentNullException

Argumen action null.

ArgumentOutOfRangeException

Argumen creationOptions menentukan nilai yang tidak valid untuk TaskCreationOptions.

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil metode statis TaskFactory.StartNew(Action, TaskCreationOptions) . Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Berlaku untuk

Task(Action<Object>, Object)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan tindakan dan status yang ditentukan.

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state);

public Task (Action<object> action, object state);

public Task (Action<object?> action, object? state);

new System.Threading.Tasks.Task : Action<obj> * obj -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object)

Parameter

action: Action<Object>

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan.

Pengecualian

ArgumentNullException

Argumen action null.

Contoh

Contoh berikut mendefinisikan array kata 6 huruf. Setiap kata kemudian diteruskan sebagai argumen ke Task(Action<Object>, Object) konstruktor, yang delegasinya Action<T> mengacak karakter dalam kata, lalu menampilkan kata asli dan versi orak-ariknya.

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

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

      foreach (var word6 in words6) {
         Task t = new Task( (word) => { Char[] chars = word.ToString().ToCharArray();
                                        double[] order = new double[chars.Length];
                                        lock (lockObj) {
                                           for (int ctr = 0; ctr < order.Length; ctr++)
                                              order[ctr] = rnd.NextDouble();
                                           }
                                        Array.Sort(order, chars);
                                        Console.WriteLine("{0} --> {1}", word,
                                                          new String(chars));
                                      }, word6);
         t.Start();
         tasks.Add(t);
      }
      await Task.WhenAll(tasks.ToArray());
   }
}
// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird

open System
open System.Threading.Tasks

let main =
    task {
        let tasks = ResizeArray()
        let rnd = Random()
        let lockObj = obj ()

        let words6 =
            [ "reason"
              "editor"
              "rioter"
              "rental"
              "senior"
              "regain"
              "ordain"
              "rained" ]

        for word6 in words6 do
            let t =
                new Task(
                    (fun word ->
                        let chars = (string word).ToCharArray()
                        let order = Array.zeroCreate<double> chars.Length

                        lock lockObj (fun () ->
                            for i = 0 to order.Length - 1 do
                                order[i] <- rnd.NextDouble())

                        Array.Sort(order, chars)
                        printfn $"{word} --> {new String(chars)}"),
                    word6
                )

            t.Start()
            tasks.Add t

        do! tasks.ToArray() |> Task.WhenAll
    }

main.Wait()

// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird

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

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

      For Each word6 in words6
         Dim t As New Task( Sub(word)
                               Dim chars() As Char = word.ToString().ToCharArray()
                               Dim order(chars.Length - 1) As Double
                               SyncLock lockObj
                                  For ctr As Integer = 0 To order.Length - 1
                                     order(ctr) = rnd.NextDouble()
                                  Next
                               End SyncLock
                               Array.Sort(order, chars)
                               Console.WriteLine("{0} --> {1}", word,
                                                 New String(chars))
                            End Sub, word6)
         t.Start()
         tasks.Add(t)
      Next
      Task.WaitAll(tasks.ToArray())
   End Sub
End Module
' The example displays output like the following:
'       regain --> irnaeg
'       ordain --> rioadn
'       reason --> soearn
'       rained --> rinade
'       rioter --> itrore
'       senior --> norise
'       rental --> atnerl
'       editor --> oteird

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil metode statis TaskFactory.StartNew(Action<Object>, Object) . Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Lihat juga

StartNew(Action<Object>, Object)

Berlaku untuk

Task(Action, CancellationToken, TaskCreationOptions)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan opsi tindakan dan pembuatan yang ditentukan.

public:
 Task(Action ^ action, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action action, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions)

Parameter

action: Action

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

cancellationToken: CancellationToken

Tugas CancellationToken baru yang akan diamati.

creationOptions: TaskCreationOptions

yang TaskCreationOptions digunakan untuk menyesuaikan perilaku tugas.

Pengecualian

ObjectDisposedException

Yang CancellationTokenSource dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumen action null.

ArgumentOutOfRangeException

Argumen creationOptions menentukan nilai yang tidak valid untuk TaskCreationOptions.

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil metode statis TaskFactory.StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler) . Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Untuk informasi selengkapnya, lihat Paralelisme Tugas (Pustaka Paralel Tugas) dan Pembatalan Tugas.

Berlaku untuk

Task(Action<Object>, Object, CancellationToken)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan tindakan, status, dan CancellationToken.

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public Task (Action<object> action, object state, System.Threading.CancellationToken cancellationToken);

public Task (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken);

new System.Threading.Tasks.Task : Action<obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object, cancellationToken As CancellationToken)

Parameter

action: Action<Object>

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan.

cancellationToken: CancellationToken

Tugas CancellationToken baru yang akan diamati.

Pengecualian

ObjectDisposedException

Yang CancellationTokenSource dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumen action null.

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil metode statis TaskFactory.StartNew(Action<Object>, Object, CancellationToken) . Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Berlaku untuk

Task(Action<Object>, Object, TaskCreationOptions)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan tindakan, status, dan opsi yang ditentukan.

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action<object> action, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);

public Task (Action<object?> action, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action<obj> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object, creationOptions As TaskCreationOptions)

Parameter

action: Action<Object>

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan.

creationOptions: TaskCreationOptions

yang TaskCreationOptions digunakan untuk menyesuaikan perilaku tugas.

Pengecualian

ArgumentNullException

Argumen action null.

ArgumentOutOfRangeException

Argumen creationOptions menentukan nilai yang tidak valid untuk TaskCreationOptions.

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil metode statis TaskFactory.StartNew(Action<Object>, Object, TaskCreationOptions) . Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Berlaku untuk

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Sumber:: Task.cs

Sumber:: Task.cs

Sumber:: Task.cs

Menginisialisasi baru Task dengan tindakan, status, dan opsi yang ditentukan.

public:
 Task(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);

public Task (Action<object> action, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);

public Task (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);

new System.Threading.Tasks.Task : Action<obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Sub New (action As Action(Of Object), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions)

Parameter

action: Action<Object>

Delegasi yang mewakili kode untuk dijalankan dalam tugas.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan.

cancellationToken: CancellationToken

Tugas CancellationToken baru yang akan diamati.

creationOptions: TaskCreationOptions

yang TaskCreationOptions digunakan untuk menyesuaikan perilaku tugas.

Pengecualian

ObjectDisposedException

Yang CancellationTokenSource dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumen action null.

ArgumentOutOfRangeException

Argumen creationOptions menentukan nilai yang tidak valid untuk TaskCreationOptions.

Keterangan

Daripada memanggil konstruktor ini, cara paling umum untuk membuat Task instans objek dan meluncurkan tugas adalah dengan memanggil metode statis TaskFactory.StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) . Satu-satunya keuntungan yang ditawarkan oleh konstruktor ini adalah memungkinkan instansiasi objek dipisahkan dari pemanggilan tugas.

Berlaku untuk

Task Konstruktor

Definisi

Overload

Task(Action)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Task(Action, CancellationToken)

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

Task(Action, TaskCreationOptions)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Task(Action<Object>, Object)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Task(Action, CancellationToken, TaskCreationOptions)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Task(Action<Object>, Object, CancellationToken)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Task(Action<Object>, Object, TaskCreationOptions)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: