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

Définition

Crée un nouveau IAsyncResult à partir du spécifié Task, en appelant callback éventuellement une fois la tâche 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

à Task encapsuler dans un IAsyncResult.

callback
AsyncCallback

Rappel à appeler à taskl’achèvement de . Si nullla valeur est , aucun rappel n’est appelé.

state
Object

État à stocker dans .IAsyncResult

Retours

pour IAsyncResult représenter l’opération asynchrone de la tâche. Cette instance est également passée à callback lorsqu’elle est appelée.

Exceptions

task a la valeur null.

Remarques

Conjointement avec les End(IAsyncResult) méthodes ou End<TResult>(IAsyncResult) , cette méthode peut être utilisée pour implémenter le modèle Begin/End (également appelé modèle de programmation asynchrone ou APM). Il est recommandé de ne pas exposer ce modèle dans le nouveau code ; les méthodes sur 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 pour des raisons de compatibilité. Ces méthodes permettent d’implémenter toute la logique asynchrone principale via Tasks, puis d’implémenter facilement des méthodes Begin/End autour de cette fonctionnalité.

S’applique à