ExecutionContext Classe

Définition

Gère le contexte d'exécution pour le thread actuel.Manages the execution context for the current thread. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class ExecutionContext sealed
public ref class ExecutionContext sealed : IDisposable, System::Runtime::Serialization::ISerializable
public ref class ExecutionContext sealed : System::Runtime::Serialization::ISerializable
public sealed class ExecutionContext
public sealed class ExecutionContext : IDisposable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public sealed class ExecutionContext : System.Runtime.Serialization.ISerializable
[System.Serializable]
public sealed class ExecutionContext : IDisposable, System.Runtime.Serialization.ISerializable
type ExecutionContext = class
type ExecutionContext = class
    interface IDisposable
    interface ISerializable
type ExecutionContext = class
    interface ISerializable
Public NotInheritable Class ExecutionContext
Public NotInheritable Class ExecutionContext
Implements IDisposable, ISerializable
Public NotInheritable Class ExecutionContext
Implements ISerializable
Héritage
ExecutionContext
Attributs
Implémente

Remarques

La classe ExecutionContext fournit un conteneur unique pour toutes les informations relatives à un thread d’exécution logique.The ExecutionContext class provides a single container for all information relevant to a logical thread of execution. Cela comprend le contexte de sécurité, le contexte d’appel et le contexte de synchronisation.This includes security context, call context, and synchronization context.

La classe ExecutionContext fournit les fonctionnalités permettant au code utilisateur de capturer et de transférer ce contexte sur des points asynchrones définis par l’utilisateur.The ExecutionContext class provides the functionality for user code to capture and transfer this context across user-defined asynchronous points. Le common language runtime garantit que le ExecutionContext est régulièrement transféré à travers des points asynchrones définis par l’exécution au sein du processus managé.The common language runtime ensures that the ExecutionContext is consistently transferred across runtime-defined asynchronous points within the managed process.

Un contexte d’exécution est l’équivalent managé d’un cloisonnement COM.An execution context is the managed equivalent of a COM apartment. Au sein d’un domaine d’application, le contexte d’exécution entier doit être transféré chaque fois qu’un thread est transféré.Within an application domain, the entire execution context must be transferred whenever a thread is transferred. Cette situation se produit pendant les transferts effectués par la méthode Thread.Start, la plupart des opérations de pool de threads et le marshaling de thread Windows Forms par le biais de la pompe de messages Windows.This situation occurs during transfers made by the Thread.Start method, most thread pool operations, and Windows Forms thread marshaling through the Windows message pump. Elle ne se produit pas dans les opérations de pool de threads non sécurisées (telles que la méthode UnsafeQueueUserWorkItem), qui ne transfèrent pas la pile compressée.It does not occur in unsafe thread pool operations (such as the UnsafeQueueUserWorkItem method), which do not transfer the compressed stack. Quel que soit le flux de pile compressé, le principal managé, la synchronisation, les paramètres régionaux et le contexte utilisateur sont également transmis.Wherever the compressed stack flows, the managed principal, synchronization, locale, and user context also flow. La classe ExecutionContext fournit les méthodes Capture et CreateCopy pour obtenir le contexte d’exécution et la méthode Run pour définir le contexte d’exécution du thread actuel.The ExecutionContext class provides the Capture and CreateCopy methods to get the execution context and the Run method to set the execution context for the current thread.

Une ExecutionContext associée à un thread ne peut pas être définie sur un autre thread.An ExecutionContext that is associated with a thread cannot be set on another thread. Toute tentative de ce faire entraînera la levée d’une exception.Attempting to do so will result in an exception being thrown. Pour propager le ExecutionContext d’un thread à un autre, effectuez une copie du ExecutionContext.To propagate the ExecutionContext from one thread to another, make a copy of the ExecutionContext.

En interne, l' ExecutionContext stocke toutes les données associées au LogicalCallContext.Internally, the ExecutionContext stores all data that is associated with the LogicalCallContext. Cela permet de propager les données de LogicalCallContext lors de la copie et du transfert du ExecutionContext.This allows the LogicalCallContext data to be propagated when the ExecutionContext is copied and transferred.

Méthodes

Capture()

Capture le contexte d'exécution du thread actuel.Captures the execution context from the current thread.

CreateCopy()

Crée une copie du contexte d'exécution actuel.Creates a copy of the current execution context.

Dispose()

Libère toutes les ressources utilisées par l'instance actuelle de la classe ExecutionContext.Releases all resources used by the current instance of the ExecutionContext class.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)

Définit l'objet SerializationInfo spécifié avec les informations de contexte logiques nécessaires à la recréation d'une instance du contexte d'exécution en cours.Sets the specified SerializationInfo object with the logical context information needed to recreate an instance of the current execution context.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IsFlowSuppressed()

Indique si le flux du contexte d'exécution est actuellement supprimé.Indicates whether the flow of the execution context is currently suppressed.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RestoreFlow()

Restaure le flux du contexte d'exécution sur des threads asynchrones.Restores the flow of the execution context across asynchronous threads.

Run(ExecutionContext, ContextCallback, Object)

Exécute une méthode dans un contexte d'exécution spécifié sur le thread actuel.Runs a method in a specified execution context on the current thread.

SuppressFlow()

Supprime le flux du contexte d'exécution sur des threads asynchrones.Suppresses the flow of the execution context across asynchronous threads.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à