TaskToAsyncResult.Begin(Task, AsyncCallback, Object) Méthode

Définition

Crée un nouveau IAsyncResult à partir de l’appel callback spécifiéTask, éventuellement lorsque la tâche est terminée.

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

Paramètres

task
Task

Devant Task être encapsulé dans un IAsyncResult.

callback
AsyncCallback

Rappel à appeler à taskla fin de l’opération. Si null, aucun rappel n’est appelé.

state
Object

État à stocker dans le IAsyncResult.

Retours

Représentant IAsyncResult l’opération asynchrone de la tâche. Cette instance est également transmise callback au moment où elle est appelée.

Exceptions

task a la valeur null.

Remarques

Conjointement avec les méthodes ou End<TResult>(IAsyncResult) les End(IAsyncResult) méthodes, cette méthode peut être utilisée pour implémenter le modèle Begin/End (également appelé modèle de modèle de programmation asynchrone ou APM). Il est recommandé de ne pas exposer ce modèle dans le nouveau code ; les méthodes activées TaskToAsyncResult sont destinées uniquement à aider à implémenter ces méthodes Begin/End lorsqu’elles doivent être exposées, par exemple parce qu’une classe de base fournit des méthodes virtuelles pour le modèle, ou lorsqu’elles ont déjà été exposées et doivent rester compatibles. Ces méthodes permettent d’implémenter l’ensemble de la logique asynchrone principale via Tasks, puis d’implémenter facilement les méthodes Begin/End autour de cette fonctionnalité.

S’applique à