WorkItemHandler Delegat

Definition

Namespace:

Windows.System.Threading

Stellt eine Methode dar, die aufgerufen wird, wenn ein Arbeitselement ausgeführt wird.

public delegate void WorkItemHandler(IAsyncAction ^ operation);

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(488278923, 64102, 16719, 156, 189, 182, 95, 201, 157, 23, 250)]
class WorkItemHandler : MulticastDelegate

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(488278923, 64102, 16719, 156, 189, 182, 95, 201, 157, 23, 250)]
public delegate void WorkItemHandler(IAsyncAction operation);

Public Delegate Sub WorkItemHandler(operation As IAsyncAction)

Parameter

operation

IAsyncAction

Das Arbeitselement, das der Rückrufmethode zugeordnet werden soll.

Attribute

ContractVersionAttribute GuidAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Der Threadpool ruft den WorkItemHandler-Delegat eines Arbeitselements auf, wenn ein Thread zum Ausführen des Arbeitselements verfügbar wird. Wenn ein Arbeitselement abgebrochen wird, werden WorkItemHandler-Delegaten, die noch nicht mit der Ausführung begonnen haben, nicht aufgerufen. WorkItemHandler-Delegaten, die bereits ausgeführt werden, dürfen abgeschlossen werden, es sei denn, die Anwendung beendet sie. Wenn ein Arbeitselement möglicherweise relativ lange ausgeführt wird, sollte die Anwendung überprüfen, ob der Abbruch angefordert wurde, und den Handler in geordneter Weise beenden.

Ein Beispiel finden Sie unter Übermitteln eines Arbeitselements an den Threadpool.