TaskFactory<TResult>.StartNew Metoda

Definicja

Przestrzeń nazw:

System.Threading.Tasks

Zestaw:

System.Runtime.dll

Tworzy i uruchamia zadanie.

Przeciążenia

StartNew(Func<Object,TResult>, Object, CancellationToken)	Tworzy i uruchamia zadanie.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	Tworzy i uruchamia zadanie.
StartNew(Func<TResult>, TaskCreationOptions)	Tworzy i uruchamia zadanie.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Tworzy i uruchamia zadanie.
StartNew(Func<Object,TResult>, Object)	Tworzy i uruchamia zadanie.
StartNew(Func<TResult>)	Tworzy i uruchamia zadanie.
StartNew(Func<TResult>, CancellationToken)	Tworzy i uruchamia zadanie.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Tworzy i uruchamia zadanie.

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

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 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 (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 (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

Parametry

function

Func<Object,TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

state

Object

Obiekt, który zawiera dane, które mają być używane przez delegata function .

cancellationToken

CancellationToken

Token anulowania, który zostanie przypisany do nowego zadania.

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ObjectDisposedException

Źródło tokenu anulowania, które zostało już utworzone cancellationToken , zostało usunięte.

ArgumentNullException

Argumentem function jest null.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

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

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 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 (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 (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

Parametry

function

Func<Object,TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

state

Object

Obiekt, który zawiera dane, które mają być używane przez delegata function .

creationOptions

TaskCreationOptions

Jedna z wartości wyliczenia, która kontroluje zachowanie utworzonego zadania.

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ArgumentNullException

Argumentem function jest null.

ArgumentOutOfRangeException

Parametr creationOptions określa nieprawidłową wartość.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

StartNew(Func<TResult>, TaskCreationOptions)

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (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 (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

Parametry

function

Func<TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

creationOptions

TaskCreationOptions

Jedna z wartości wyliczenia, która kontroluje zachowanie utworzonego zadania.

Zwraca

Task<TResult>

Task<TResult>Uruchomiono element .

Wyjątki

ArgumentNullException

Argumentem function jest null.

ArgumentOutOfRangeException

Parametr creationOptions określa nieprawidłową wartość.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

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

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 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 (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 (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parametry

function

Func<TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

cancellationToken

CancellationToken

Token anulowania, który zostanie przypisany do nowego zadania.

creationOptions

TaskCreationOptions

Jedna z wartości wyliczenia, która kontroluje zachowanie utworzonego zadania.

scheduler

TaskScheduler

Harmonogram zadań używany do planowania utworzonego zadania.

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ObjectDisposedException

Źródło tokenu anulowania, które zostało już utworzone cancellationToken , zostało usunięte.

ArgumentNullException

Argumentem function jest null.

-lub-

Argumentem scheduler jest null.

ArgumentOutOfRangeException

Parametr creationOptions określa nieprawidłową wartość.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

StartNew(Func<Object,TResult>, Object)

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state);

member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

Parametry

function

Func<Object,TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

state

Object

Obiekt, który zawiera dane, które mają być używane przez delegata function .

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ArgumentNullException

Argumentem function jest null.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

StartNew(Func<TResult>)

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function);

member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult)) As Task(Of TResult)

Parametry

function

Func<TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ArgumentNullException

Argumentem function jest null.

Uwagi

Wywołanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywołuje metodę Start w celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

StartNew(Func<TResult>, CancellationToken)

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

Parametry

function

Func<TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

cancellationToken

CancellationToken

Token anulowania, który zostanie przypisany do nowego zadania.

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ObjectDisposedException

Źródło tokenu anulowania, które zostało już utworzone cancellationToken , zostało usunięte.

ArgumentNullException

Argumentem function jest null.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi

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

Źródło:

FutureFactory.cs

Tworzy i uruchamia zadanie.

public:
 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 (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 (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parametry

function

Func<Object,TResult>

Delegat funkcji, który zwraca przyszły wynik, aby był dostępny za pośrednictwem zadania.

state

Object

Obiekt, który zawiera dane, które mają być używane przez delegata function .

cancellationToken

CancellationToken

Token anulowania, który zostanie przypisany do nowego zadania.

creationOptions

TaskCreationOptions

Jedna z wartości wyliczenia, która kontroluje zachowanie utworzonego zadania.

scheduler

TaskScheduler

Harmonogram zadań używany do planowania utworzonego zadania.

Zwraca

Task<TResult>

Rozpoczęte zadanie.

Wyjątki

ObjectDisposedException

Źródło tokenu anulowania, które zostało już utworzone cancellationToken , zostało usunięte.

ArgumentNullException

Argumentem function jest null.

-lub-

Argumentem scheduler jest null.

ArgumentOutOfRangeException

Parametr creationOptions określa nieprawidłową wartość.

Uwagi

Wywoływanie StartNew jest funkcjonalnie równoważne tworzeniu zadania przy użyciu jednego z Task<TResult> konstruktorów, a następnie wywoływanie metody w Start celu zaplanowania jej wykonania.

Jednak jeśli tworzenie i planowanie nie muszą być oddzielone, StartNew jest zalecanym podejściem zarówno dla uproszczenia, jak i wydajności.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Korzystanie z modelu TPL z innymi wzorami asynchronicznymi