CancellationToken.Register Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Regista um delegado que será chamado quando este CancellationToken for cancelado.
Sobrecargas
| Name | Description |
|---|---|
| Register(Action) |
Regista um delegado que será chamado quando este CancellationToken for cancelado. |
| Register(Action, Boolean) |
Regista um delegado que será chamado quando este CancellationToken for cancelado. |
| Register(Action<Object>, Object) |
Regista um delegado que será chamado quando este CancellationToken for cancelado. |
| Register(Action<Object>, Object, Boolean) |
Regista um delegado que será chamado quando este CancellationToken for cancelado. |
Register(Action)
Regista um delegado que será chamado quando este CancellationToken for cancelado.
public:
System::Threading::CancellationTokenRegistration Register(Action ^ callback);
public System.Threading.CancellationTokenRegistration Register(Action callback);
member this.Register : Action -> System.Threading.CancellationTokenRegistration
Public Function Register (callback As Action) As CancellationTokenRegistration
Parâmetros
- callback
- Action
O delegado a ser executado quando o CancellationToken for cancelado.
Devoluções
A CancellationTokenRegistration instância que pode ser usada para desregistar o callback.
Exceções
O associado CancellationTokenSource foi eliminado.
callback é null.
Observações
Se este token já estiver no estado cancelado, o delegado será executado imediatamente e de forma síncrona. Qualquer exceção que o delegado gerar será propagada a partir desta chamada de método.
A corrente ExecutionContext é captada juntamente com o delegado e será usada na sua execução.
A corrente SynchronizationContext não é captada.
Ver também
- Cancelamento
- Cancelamento de Tarefas
- Como: Registar Retornos de Chamada para Pedidos de Cancelamento
Aplica-se a
Register(Action, Boolean)
Regista um delegado que será chamado quando este CancellationToken for cancelado.
public:
System::Threading::CancellationTokenRegistration Register(Action ^ callback, bool useSynchronizationContext);
public System.Threading.CancellationTokenRegistration Register(Action callback, bool useSynchronizationContext);
member this.Register : Action * bool -> System.Threading.CancellationTokenRegistration
Public Function Register (callback As Action, useSynchronizationContext As Boolean) As CancellationTokenRegistration
Parâmetros
- callback
- Action
O delegado a ser executado quando o CancellationToken for cancelado.
- useSynchronizationContext
- Boolean
Um valor que indica se deve capturar a corrente SynchronizationContext e usá-la ao invocar o callback.
Devoluções
A CancellationTokenRegistration instância que pode ser usada para desregistar o callback.
Exceções
O associado CancellationTokenSource foi eliminado.
callback é null.
Observações
Se este token já estiver no estado cancelado, o delegado será executado imediatamente e de forma síncrona. Qualquer exceção que o delegado gerar será propagada a partir desta chamada de método.
A corrente ExecutionContext é captada juntamente com o delegado e será usada na sua execução.
Se useSynchronizationContext for true, o atual SynchronizationContext, se existir um, também é capturado juntamente com o delegado e será usado na sua execução. Caso contrário, SynchronizationContext não é capturado.
Ver também
- Cancelamento
- Cancelamento de Tarefas
- Como: Registar Retornos de Chamada para Pedidos de Cancelamento
Aplica-se a
Register(Action<Object>, Object)
Regista um delegado que será chamado quando este CancellationToken for cancelado.
public:
System::Threading::CancellationTokenRegistration Register(Action<System::Object ^> ^ callback, System::Object ^ state);
public System.Threading.CancellationTokenRegistration Register(Action<object> callback, object state);
member this.Register : Action<obj> * obj -> System.Threading.CancellationTokenRegistration
Public Function Register (callback As Action(Of Object), state As Object) As CancellationTokenRegistration
Parâmetros
O delegado a ser executado quando o CancellationToken for cancelado.
- state
- Object
O estado a passar para o callback quando o delegado é invocado. Isto pode ser nulo.
Devoluções
A CancellationTokenRegistration instância que pode ser usada para desregistar o callback.
Exceções
O associado CancellationTokenSource foi eliminado.
callback é null.
Observações
Se este token já estiver no estado cancelado, o delegado será executado imediatamente e de forma síncrona. Qualquer exceção que o delegado gerar será propagada a partir desta chamada de método.
A corrente ExecutionContext é captada juntamente com o delegado e será usada na sua execução.
A corrente SynchronizationContext não é captada.
Ver também
- Cancelamento
- Cancelamento de Tarefas
- Como: Registar Retornos de Chamada para Pedidos de Cancelamento
Aplica-se a
Register(Action<Object>, Object, Boolean)
Regista um delegado que será chamado quando este CancellationToken for cancelado.
public:
System::Threading::CancellationTokenRegistration Register(Action<System::Object ^> ^ callback, System::Object ^ state, bool useSynchronizationContext);
public System.Threading.CancellationTokenRegistration Register(Action<object> callback, object state, bool useSynchronizationContext);
member this.Register : Action<obj> * obj * bool -> System.Threading.CancellationTokenRegistration
Public Function Register (callback As Action(Of Object), state As Object, useSynchronizationContext As Boolean) As CancellationTokenRegistration
Parâmetros
O delegado a ser executado quando o CancellationToken for cancelado.
- state
- Object
O estado a passar para o callback quando o delegado é invocado. Isto pode ser nulo.
- useSynchronizationContext
- Boolean
Um valor booleano que indica se deve capturar a corrente SynchronizationContext e usá-la ao invocar o callback.
Devoluções
A CancellationTokenRegistration instância que pode ser usada para desregistar o callback.
Exceções
O associado CancellationTokenSource foi eliminado.
callback é null.
Observações
Se este token já estiver no estado cancelado, o delegado será executado imediatamente e de forma síncrona. Qualquer exceção que o delegado gerar será propagada a partir desta chamada de método.
A corrente ExecutionContext é captada juntamente com o delegado e será usada na sua execução.
Se useSynchronizationContext for true, o atual SynchronizationContext, se existir um, também é capturado juntamente com o delegado e será usado na sua execução. Caso contrário, SynchronizationContext não é capturado.
Ver também
- Cancelamento
- Cancelamento de Tarefas
- Como: Registar Retornos de Chamada para Pedidos de Cancelamento