WorkItemHandler Delegar

Definição

Namespace:

Windows.System.Threading

Representa um método chamado quando um item de trabalho é executado.

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)

Parâmetros

operation

IAsyncAction

O item de trabalho a ser associado ao método de retorno de chamada.

Atributos

ContractVersionAttribute GuidAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

O pool de threads chama um delegado WorkItemHandler de um item de trabalho quando um thread fica disponível para executar o item de trabalho. Se um item de trabalho for cancelado, os delegados do WorkItemHandler que ainda não começaram a ser executados não serão chamados. Os delegados workItemHandler que já estão em execução têm permissão para serem concluídos, a menos que o aplicativo os pare. Se um item de trabalho pode ser executado por um tempo relativamente longo, o aplicativo deverá marcar se o cancelamento tiver sido solicitado e interromper o manipulador de forma ordenada.

Para obter um exemplo, consulte Enviar um item de trabalho para o pool de threads.