TaskToAsyncResult.Begin(Task, AsyncCallback, Object) Methode

Definitie

Hiermee maakt u een nieuwe IAsyncResult op basis van de opgegeven Task, optioneel aanroepen callback wanneer de taak is voltooid.

public:
 static IAsyncResult ^ Begin(System::Threading::Tasks::Task ^ task, AsyncCallback ^ callback, System::Object ^ state);
public static IAsyncResult Begin(System.Threading.Tasks.Task task, AsyncCallback? callback, object? state);
static member Begin : System.Threading.Tasks.Task * AsyncCallback * obj -> IAsyncResult
Public Shared Function Begin (task As Task, callback As AsyncCallback, state As Object) As IAsyncResult

Parameters

task
Task

De Task te verpakken in een IAsyncResult.

callback
AsyncCallback

De callback die moet worden aangeroepen na taskvoltooiing. Als nuller geen callback wordt aangeroepen.

state
Object

De status die moet worden opgeslagen in de IAsyncResult.

Retouren

Een IAsyncResult om de asynchrone bewerking van de taak weer te geven. Dit exemplaar wordt ook doorgegeven callback wanneer deze wordt aangeroepen.

Uitzonderingen

task is null.

Opmerkingen

In combinatie met de End(IAsyncResult) of End<TResult>(IAsyncResult) methoden kan deze methode worden gebruikt voor het implementeren van het begin-/eindpatroon (ook wel het Asynchrone programmeermodelpatroon of APM genoemd). Het wordt aanbevolen om dit patroon niet beschikbaar te maken in nieuwe code; de methoden TaskToAsyncResult op zijn alleen bedoeld om dergelijke begin-/eindmethoden te implementeren wanneer ze moeten worden weergegeven, bijvoorbeeld omdat een basisklasse virtuele methoden biedt voor het patroon, of wanneer ze al beschikbaar zijn en voor compatibiliteit moeten blijven. Met deze methoden kunt u alle asynchrone kernlogica implementeren via Tasks en vervolgens eenvoudig begin-/eindmethoden rondom die functionaliteit implementeren.

Van toepassing op