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

Définition

Espace de noms:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Source:

TaskToAsyncResult.cs

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

IAsyncResult

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

ArgumentNullException

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é.