Task<TResult> Task<TResult> Task<TResult> Task<TResult> Constructors

Definition

Überlädt

Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>)

Initialisiert einen neuen Task<TResult> mit der angegebenen Funktion.Initializes a new Task<TResult> with the specified function.

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Funktion und Zustand.Initializes a new Task<TResult> with the specified function and state.

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

Initialisiert einen neuen Task<TResult> mit der angegebenen Funktion.Initializes a new Task<TResult> with the specified function.

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Funktion und Erstellungsoptionen.Initializes a new Task<TResult> with the specified function and creation options.

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Aktion, Zustand und Optionen.Initializes a new Task<TResult> with the specified action, state, and options.

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Aktion, Zustand und Optionen.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Funktion und Erstellungsoptionen.Initializes a new Task<TResult> with the specified function and creation options.

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Aktion, Zustand und Optionen.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>)

Initialisiert einen neuen Task<TResult> mit der angegebenen Funktion.Initializes a new Task<TResult> with the specified function.

public:
 Task(Func<TResult> ^ function);
public Task (Func<TResult> function);
new System.Threading.Tasks.Task<'Result> : Func<'Result> -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of TResult))

Parameter

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

Ausnahmen

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Beispiele

Im folgenden Beispiel wird die ungefähre Anzahl von Wörtern in Textdateien gezählt, die veröffentlichte Bücher darstellen.The following example counts the approximate number of words in text files that represent published books. Jede Aufgabe ist für das Öffnen einer Datei, das asynchrone Lesen des gesamten Inhalts und das Berechnen der Wort Anzahl mithilfe eines regulären Ausdrucks verantwortlich.Each task is responsible for opening a file, reading its entire contents asynchronously, and calculating the word count by using a regular expression. Die Task.WaitAll(Task[]) -Methode wird aufgerufen, um sicherzustellen, dass alle Aufgaben abgeschlossen sind, bevor die Wort Anzahl der einzelnen Bücher in der Konsole angezeigt wird.The Task.WaitAll(Task[]) method is called to ensure that all tasks have completed before displaying the word count of each book to the console.

Die Objekt Instanziierung ist in diesem Beispiel von der Objekt Ausführung getrennt, sodass das Beispiel sicherstellen kann, dass jede Datei vorhanden ist.Object instantiation is separated from object execution in this example so that the example can ensure that each file exists. Wenn dies nicht der Fall ist, wird der Name der fehlenden Datei angezeigt.If they do not, it displays the name of the missing file. Andernfalls wird die-Methode Task.Start aufgerufen, um die einzelnen Aufgaben zu starten.Otherwise, it calls the Task.Start method to launch each task.

using System;
using System.IO;
using System.Text.RegularExpressions;
using System.Threading.Tasks;

public class Example
{
   public static async Task Main()
   {
      string pattern = @"\p{P}*\s+";
      string[] titles = { "Sister Carrie", "The Financier" };
      Task<int>[] tasks = new Task<int>[titles.Length];

      for (int ctr = 0; ctr < titles.Length; ctr++) {
         string s = titles[ctr];
         tasks[ctr] = new Task<int>( () => {
                                   // Number of words.
                                   int nWords = 0;
                                   // Create filename from title.
                                   string fn = s + ".txt";

                                   StreamReader sr = new StreamReader(fn);
                                   string input = sr.ReadToEndAsync().Result;
                                   sr.Close();
                                   nWords = Regex.Matches(input, pattern).Count;
                                   return nWords;
                                } );
      }
      // Ensure files exist before launching tasks.
      bool allExist = true;
      foreach (var title in titles) {
         string fn = title + ".txt";
         if (! File.Exists(fn)) {
            allExist = false;
            Console.WriteLine("Cannot find '{0}'", fn);
            break;
         }   
      }
      // Launch tasks 
      if (allExist) {
         foreach (var t in tasks)
            t.Start();
      
        await Task.WhenAll(tasks);
  
        Console.WriteLine("Word Counts:\n");
        for (int ctr = 0; ctr < titles.Length; ctr++)
           Console.WriteLine("{0}: {1,10:N0} words", titles[ctr], tasks[ctr].Result);
      }   
   }
}
// The example displays the following output:
//       Sister Carrie:    159,374 words
//       The Financier:    196,362 words
Imports System.IO
Imports System.Text.RegularExpressions
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim pattern As String = "\p{P}*\s+"
      Dim titles() As String = { "Sister Carrie",
                                 "The Financier" }
      Dim tasks(titles.Length - 1) As Task(Of Integer)

      For ctr As Integer = 0 To titles.Length - 1
         Dim s As String = titles(ctr)
         tasks(ctr) = New Task(Of Integer)( Function()
                                   ' Number of words.
                                   Dim nWords As Integer = 0
                                   ' Create filename from title.
                                   Dim fn As String = s + ".txt"

                                   Dim sr As New StreamReader(fn)
                                   Dim input As String = sr.ReadToEndAsync().Result
                                   sr.Close()
                                   nWords = Regex.Matches(input, pattern).Count
                                   Return nWords
                                End Function)
      Next

      ' Ensure files exist before launching tasks.
      Dim allExist As Boolean = True
      For Each title In titles
         Dim fn As String = title + ".txt"
         If Not File.Exists(fn) Then
            allExist = false
            Console.WriteLine("Cannot find '{0}'", fn)
            Exit For
         End If   
      Next
      ' Launch tasks 
      If allExist Then
         For Each t in tasks
            t.Start()
         Next
         Task.WaitAll(tasks)

         Console.WriteLine("Word Counts:")
         Console.WriteLine()
         For ctr As Integer = 0 To titles.Length - 1
         Console.WriteLine("{0}: {1,10:N0} words", titles(ctr), tasks(ctr).Result)
         Next
      End If   
   End Sub
End Module
' The example displays the following output:
'       Sister Carrie:    159,374 words
'       The Financier:    196,362 words

Das Muster \p{P}*\s+ für reguläre Ausdrücke entspricht keinem, einem oder mehreren Interpunktions Zeichen, gefolgt von einem oder mehreren Leerzeichen.The regular expression pattern \p{P}*\s+ matches zero, one, or more punctuation characters followed by one or more white-space characters. Dabei wird davon ausgegangen, dass die Gesamtzahl der Übereinstimmungen gleich der ungefähren Wort Anzahl ist.It assumes that the total number of matches equals the approximate word count.

Hinweise

Dieser Konstruktor sollte nur in erweiterten Szenarien verwendet werden, in denen es erforderlich ist, dass die Erstellung und der Start der Aufgabe getrennt werden.This constructor should only be used in advanced scenarios where it is required that the creation and starting of the task is separated.

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen Task.Run<TResult>(Func<TResult>) der TaskFactory<TResult>.StartNew(Func<TResult>) statischen-Methode und der-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static Task.Run<TResult>(Func<TResult>) and TaskFactory<TResult>.StartNew(Func<TResult>) methods.

Wenn eine Aufgabe ohne Aktion nur für den Consumer einer API erforderlich ist, um etwas zu erwarten, sollte eine TaskCompletionSource<TResult> verwendet werden.If a task with no action is needed just for the consumer of an API to have something to await, a TaskCompletionSource<TResult> should be used.

Siehe auch

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Funktion und Zustand.Initializes a new Task<TResult> with the specified function and state.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state);
public Task (Func<object,TResult> function, object state);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of Object, TResult), state As Object)

Parameter

function
Func<Object,TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Ein Objekt, das Daten darstellt, die von der Aktion verwendet werden sollen.An object representing data to be used by the action.

Ausnahmen

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) der statischen-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) method. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

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

Initialisiert einen neuen Task<TResult> mit der angegebenen Funktion.Initializes a new Task<TResult> with the specified function.

public:
 Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);
public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Parameter

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das CancellationToken, das dieser Aufgabe zugewiesen werden soll.The CancellationToken to be assigned to this task.

Ausnahmen

Die CancellationTokenSource, die cancellationToken erstellt hat, wurde bereits freigegeben.The CancellationTokenSource that created cancellationToken has already been disposed.

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen Task.Run<TResult>(Func<TResult>, CancellationToken) der TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) statischen-Methode und der-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static Task.Run<TResult>(Func<TResult>, CancellationToken) and TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) methods. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Funktion und Erstellungsoptionen.Initializes a new Task<TResult> with the specified function and creation options.

public:
 Task(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of TResult), creationOptions As TaskCreationOptions)

Parameter

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Das TaskCreationOptions, das verwendet wird, um das Verhalten der Aufgabe zu ändern.The TaskCreationOptions used to customize the task's behavior.

Ausnahmen

Das creationOptions-Argument gibt einen ungültigen Wert für TaskCreationOptions an.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) der statischen-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) method. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Aktion, Zustand und Optionen.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);
public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Parameter

function
Func<Object,TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Ein Objekt, das Daten darstellt, die von der Funktion verwendet werden sollen.An object representing data to be used by the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das CancellationToken, das der neuen Aufgabe zugewiesen werden soll.The CancellationToken to be assigned to the new task.

Ausnahmen

Die CancellationTokenSource, die cancellationToken erstellt hat, wurde bereits freigegeben.The CancellationTokenSource that created cancellationToken has already been disposed.

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) der statischen-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) method. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

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

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Aktion, Zustand und Optionen.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions)

Parameter

function
Func<Object,TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Ein Objekt, das Daten darstellt, die von der Funktion verwendet werden sollen.An object representing data to be used by the function.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Das TaskCreationOptions, das verwendet wird, um das Verhalten der Aufgabe zu ändern.The TaskCreationOptions used to customize the task's behavior.

Ausnahmen

Das creationOptions-Argument gibt einen ungültigen Wert für TaskCreationOptions an.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) der statischen-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) method. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Funktion und Erstellungsoptionen.Initializes a new Task<TResult> with the specified function and creation options.

public:
 Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Parameter

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das CancellationToken, das der neuen Aufgabe zugewiesen wird.The CancellationToken that will be assigned to the new task.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Das TaskCreationOptions, das verwendet wird, um das Verhalten der Aufgabe zu ändern.The TaskCreationOptions used to customize the task's behavior.

Ausnahmen

Die CancellationTokenSource, die cancellationToken erstellt hat, wurde bereits freigegeben.The CancellationTokenSource that created cancellationToken has already been disposed.

Das creationOptions-Argument gibt einen ungültigen Wert für TaskCreationOptions an.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) der statischen-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) method. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Initialisiert einen neuen Task<TResult> mit den angegebenen Werten für Aktion, Zustand und Optionen.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Parameter

function
Func<Object,TResult>

Der Delegat, der den in der Aufgabe auszuführenden Code darstellt.The delegate that represents the code to execute in the task. Nachdem die Funktion abgeschlossen wurde, wird die Result-Eigenschaft der Aufgabe festgelegt, um den Ergebniswert der Funktion zurückzugeben.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Ein Objekt, das Daten darstellt, die von der Funktion verwendet werden sollen.An object representing data to be used by the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das CancellationToken, das der neuen Aufgabe zugewiesen werden soll.The CancellationToken to be assigned to the new task.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Das TaskCreationOptions, das verwendet wird, um das Verhalten der Aufgabe zu ändern.The TaskCreationOptions used to customize the task's behavior.

Ausnahmen

Die CancellationTokenSource, die cancellationToken erstellt hat, wurde bereits freigegeben.The CancellationTokenSource that created cancellationToken has already been disposed.

Das creationOptions-Argument gibt einen ungültigen Wert für TaskCreationOptions an.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Das function-Argument lautet null.The function argument is null.

Das function-Argument lautet null.The function argument is null.

Hinweise

Anstatt diesen Konstruktor aufzurufen, ist die gängigste Methode zum Instanziieren Task<TResult> eines-Objekts und zum Starten einer Aufgabe das Aufrufen TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) der statischen-Methode.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) method. Der einzige von diesem Konstruktor angebotene Vorteil besteht darin, dass die Objekt Instanziierung von einem Task Aufruf getrennt werden kann.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Siehe auch

Gilt für: