TaskToAsyncResult.Begin(Task, AsyncCallback, Object) Methode

Definition

Namespace:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Source:

TaskToAsyncResult.cs

Erstellt einen neuen IAsyncResult aus dem angegebenen Task, wobei callback optional aufgerufen wird, wenn die Aufgabe abgeschlossen ist.

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

Parameter

task

Task

Der Task , der in einen IAsyncResultumschlossen werden soll.

callback

AsyncCallback

Der Rückruf, der nach taskAbschluss aufgerufen werden soll. Wenn null, wird kein Rückruf aufgerufen.

state

Object

Der Zustand, der IAsyncResultin gespeichert werden soll.

Gibt zurück

IAsyncResult

Ein IAsyncResult , um den asynchronen Vorgang des Vorgangs darzustellen. Diese instance wird auch an übergebencallback, wenn sie aufgerufen wird.

Ausnahmen

ArgumentNullException

task ist null

Hinweise

In Verbindung mit den End(IAsyncResult) Methoden oder End<TResult>(IAsyncResult) kann diese Methode verwendet werden, um das Begin/End-Muster (auch als Asynchrones Programmiermodellmuster oder APM bezeichnet) zu implementieren. Es wird empfohlen, dieses Muster nicht in neuem Code verfügbar zu machen. Die Methoden für TaskToAsyncResult dienen nur dazu, solche Begin/End-Methoden zu implementieren, wenn sie verfügbar gemacht werden müssen, z. B. weil eine Basisklasse virtuelle Methoden für das Muster bereitstellt oder wenn sie bereits verfügbar gemacht wurden und aus Kompatibilitätsgründen beibehalten werden müssen. Diese Methoden ermöglichen die Implementierung der gesamten asynchronen Kernlogik über Tasks und die einfache Implementierung von Begin/End-Methoden um diese Funktionalität herum.