TaskFactory<TResult>.StartNew Metoda

Definice

Obor názvů:

System.Threading.Tasks

Sestavení:

System.Runtime.dll

Vytvoří a spustí úlohu.

Přetížení

StartNew(Func<Object,TResult>, Object, CancellationToken)	Vytvoří a spustí úlohu.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	Vytvoří a spustí úlohu.
StartNew(Func<TResult>, TaskCreationOptions)	Vytvoří a spustí úlohu.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Vytvoří a spustí úlohu.
StartNew(Func<Object,TResult>, Object)	Vytvoří a spustí úlohu.
StartNew(Func<TResult>)	Vytvoří a spustí úlohu.
StartNew(Func<TResult>, CancellationToken)	Vytvoří a spustí úlohu.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Vytvoří a spustí úlohu.

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

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

state

Object

Objekt obsahující data, která mají být použita delegátem function .

cancellationToken

CancellationToken

Token zrušení, který bude přiřazen k novému úkolu.

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ObjectDisposedException

Vytvořený zdroj cancellationToken tokenu zrušení už byl odstraněn.

ArgumentNullException

Argument function je null.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

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

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

state

Object

Objekt obsahující data, která mají být použita delegátem function .

creationOptions

TaskCreationOptions

Jedna z hodnot výčtu, která řídí chování vytvořené úlohy.

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ArgumentNullException

Argument function je null.

ArgumentOutOfRangeException

Parametr creationOptions určuje neplatnou hodnotu.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

StartNew(Func<TResult>, TaskCreationOptions)

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

creationOptions

TaskCreationOptions

Jedna z hodnot výčtu, která řídí chování vytvořené úlohy.

Návraty

Task<TResult>

Task<TResult>Spuštěný soubor .

Výjimky

ArgumentNullException

Argument function je null.

ArgumentOutOfRangeException

Parametr creationOptions určuje neplatnou hodnotu.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

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

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

cancellationToken

CancellationToken

Token zrušení, který bude přiřazen k novému úkolu.

creationOptions

TaskCreationOptions

Jedna z hodnot výčtu, která řídí chování vytvořené úlohy.

scheduler

TaskScheduler

Plánovač úloh, který se používá k naplánování vytvořené úlohy.

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ObjectDisposedException

Vytvořený zdroj cancellationToken tokenu zrušení už byl odstraněn.

ArgumentNullException

Argument function je null.

-nebo-

Argument scheduler je null.

ArgumentOutOfRangeException

Parametr creationOptions určuje neplatnou hodnotu.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

StartNew(Func<Object,TResult>, Object)

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

state

Object

Objekt obsahující data, která mají být použita delegátem function .

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ArgumentNullException

Argument function je null.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

StartNew(Func<TResult>)

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ArgumentNullException

Argument function je null.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

StartNew(Func<TResult>, CancellationToken)

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

cancellationToken

CancellationToken

Token zrušení, který bude přiřazen k novému úkolu.

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ObjectDisposedException

Vytvořený zdroj cancellationToken tokenu zrušení už byl odstraněn.

ArgumentNullException

Argument function je null.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory

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

Source:

FutureFactory.cs

Vytvoří a spustí úlohu.

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>

Delegát funkce, který vrátí budoucí výsledek, aby byl dostupný prostřednictvím úkolu.

state

Object

Objekt obsahující data, která mají být použita delegátem function .

cancellationToken

CancellationToken

Token zrušení, který bude přiřazen k novému úkolu.

creationOptions

TaskCreationOptions

Jedna z hodnot výčtu, která řídí chování vytvořené úlohy.

scheduler

TaskScheduler

Plánovač úloh, který se používá k naplánování vytvořené úlohy.

Návraty

Task<TResult>

Spuštěný úkol.

Výjimky

ObjectDisposedException

Vytvořený zdroj cancellationToken tokenu zrušení už byl odstraněn.

ArgumentNullException

Argument function je null.

-nebo-

Argument scheduler je null.

ArgumentOutOfRangeException

Parametr creationOptions určuje neplatnou hodnotu.

Poznámky

Volání StartNew je funkčně ekvivalentní vytvoření úlohy pomocí jednoho z Task<TResult> konstruktorů a následné volání Start metody pro naplánování spuštění.

Pokud ale vytváření a plánování není nutné oddělit, StartNew doporučuje se z důvodu jednoduchosti i výkonu.

Viz také

• Task Parallel Library (TPL)
• Použití TPL s dalšími asynchronními vzory