CancellationToken.Register Méthode

Définition

Espace de noms:

System.Threading

Assembly:

System.Runtime.dll

Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.

Surcharges

Register(Action)	Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.
Register(Action, Boolean)	Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.
Register(Action<Object,CancellationToken>, Object)	Inscrit un délégué qui sera appelé lors de l’annulation de ce CancellationToken .
Register(Action<Object>, Object)	Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.
Register(Action<Object>, Object, Boolean)	Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.

Register(Action)

Source:

CancellationToken.cs

Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.

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

Paramètres

callback

Action

Délégué à exécuter lorsque CancellationToken est annulé.

Retours

CancellationTokenRegistration

Instance de CancellationTokenRegistration qui peut être utilisée pour désinscrire le rappel.

Exceptions

ObjectDisposedException

L’élément CancellationTokenSource associé a été supprimé.

ArgumentNullException

callback a la valeur null.

Remarques

Si ce jeton est déjà à l’état annulé, le délégué est exécuté immédiatement et de manière synchrone. Toute exception générée par le délégué est propagée à partir de cet appel de méthode.

Le actuel ExecutionContext est capturé avec le délégué et sera utilisé lors de son exécution.

Le actuel SynchronizationContext n’est pas capturé.

Voir aussi

• Annulation
• Annulation de tâches
• Procédure : enregistrer des rappels pour les requêtes d’annulation

Register(Action, Boolean)

Source:

CancellationToken.cs

Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.

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

Paramètres

callback

Action

Délégué à exécuter lorsque CancellationToken est annulé.

useSynchronizationContext

Boolean

Valeur qui indique s'il faut capturer le SynchronizationContext actuel et l'utiliser lors de l'appel de callback.

Retours

CancellationTokenRegistration

Instance de CancellationTokenRegistration qui peut être utilisée pour désinscrire le rappel.

Exceptions

ObjectDisposedException

L’élément CancellationTokenSource associé a été supprimé.

ArgumentNullException

callback a la valeur null.

Remarques

Si ce jeton est déjà à l’état annulé, le délégué est exécuté immédiatement et de manière synchrone. Toute exception générée par le délégué est propagée à partir de cet appel de méthode.

Le actuel ExecutionContext est capturé avec le délégué et sera utilisé lors de son exécution.

Si useSynchronizationContext a la valeur true, le actuel SynchronizationContext, s’il existe, est également capturé avec le délégué et sera utilisé lors de son exécution. Sinon, SynchronizationContext n’est pas capturé.

Voir aussi

• Annulation
• Annulation de tâches
• Procédure : enregistrer des rappels pour les requêtes d’annulation

Register(Action<Object,CancellationToken>, Object)

Source:

CancellationToken.cs

Inscrit un délégué qui sera appelé lors de l’annulation de ce CancellationToken .

public:
 System::Threading::CancellationTokenRegistration Register(Action<System::Object ^, System::Threading::CancellationToken> ^ callback, System::Object ^ state);

public System.Threading.CancellationTokenRegistration Register (Action<object?,System.Threading.CancellationToken> callback, object? state);

member this.Register : Action<obj, System.Threading.CancellationToken> * obj -> System.Threading.CancellationTokenRegistration

Public Function Register (callback As Action(Of Object, CancellationToken), state As Object) As CancellationTokenRegistration

Paramètres

callback

Action<Object,CancellationToken>

Délégué à exécuter lors de l’annulation de CancellationToken .

state

Object

État à passer à callback lorsque le délégué est appelé. Celui-ci peut être null.

Retours

CancellationTokenRegistration

Instance de CancellationTokenRegistration qui peut être utilisée pour désinscrire le rappel.

Exceptions

ArgumentNullException

callback a la valeur null.

Remarques

Si ce jeton est déjà à l’état annulé, le délégué est exécuté immédiatement et de manière synchrone. Toute exception générée par le délégué est propagée à partir de cet appel de méthode. Le actuel ExecutionContext, s’il en existe un, est capturé avec le délégué et est utilisé lors de son exécution. Le actuel SynchronizationContext n’est pas capturé.

Register(Action<Object>, Object)

Source:

CancellationToken.cs

Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.

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

Paramètres

callback

Action<Object>

Délégué à exécuter lorsque CancellationToken est annulé.

state

Object

État à passer à callback lorsque le délégué est appelé. Il peut s'agir d'une valeur null.

Retours

CancellationTokenRegistration

Instance de CancellationTokenRegistration qui peut être utilisée pour désinscrire le rappel.

Exceptions

ObjectDisposedException

L’élément CancellationTokenSource associé a été supprimé.

ArgumentNullException

callback a la valeur null.

Remarques

Si ce jeton est déjà à l’état annulé, le délégué est exécuté immédiatement et de manière synchrone. Toute exception générée par le délégué est propagée à partir de cet appel de méthode.

Le actuel ExecutionContext est capturé avec le délégué et sera utilisé lors de son exécution.

Le actuel SynchronizationContext n’est pas capturé.

Voir aussi

• Annulation
• Annulation de tâches
• Procédure : enregistrer des rappels pour les requêtes d’annulation

Register(Action<Object>, Object, Boolean)

Source:

CancellationToken.cs

Inscrit un délégué qui sera appelé lors de l'annulation du CancellationToken.

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

Paramètres

callback

Action<Object>

Délégué à exécuter lorsque CancellationToken est annulé.

state

Object

État à passer à callback lorsque le délégué est appelé. Il peut s'agir d'une valeur null.

useSynchronizationContext

Boolean

Valeur booléenne qui indique s'il faut capturer le SynchronizationContext actuel et l'utiliser lors de l'appel de callback.

Retours

CancellationTokenRegistration

Instance de CancellationTokenRegistration qui peut être utilisée pour désinscrire le rappel.

Exceptions

ObjectDisposedException

L’élément CancellationTokenSource associé a été supprimé.

ArgumentNullException

callback a la valeur null.

Remarques

Si ce jeton est déjà à l’état annulé, le délégué est exécuté immédiatement et de manière synchrone. Toute exception générée par le délégué est propagée à partir de cet appel de méthode.

Le actuel ExecutionContext est capturé avec le délégué et sera utilisé lors de son exécution.

Si useSynchronizationContext a la valeur true, le actuel SynchronizationContext, s’il existe, est également capturé avec le délégué et sera utilisé lors de son exécution. Sinon, SynchronizationContext n’est pas capturé.

Voir aussi

• Annulation
• Annulation de tâches
• Procédure : enregistrer des rappels pour les requêtes d’annulation