SynchronizationAttribute Classe

Définition

Espace de noms:

System.Runtime.Remoting.Contexts

Assembly:

mscorlib.dll

Applique un domaine de synchronisation pour le contexte actuel et tous les contextes qui partagent la même instance.

public ref class SynchronizationAttribute : System::Runtime::Remoting::Contexts::ContextAttribute, System::Runtime::Remoting::Contexts::IContributeClientContextSink, System::Runtime::Remoting::Contexts::IContributeServerContextSink

[System.AttributeUsage(System.AttributeTargets.Class)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Security.SecurityCritical]
public class SynchronizationAttribute : System.Runtime.Remoting.Contexts.ContextAttribute, System.Runtime.Remoting.Contexts.IContributeClientContextSink, System.Runtime.Remoting.Contexts.IContributeServerContextSink

[<System.AttributeUsage(System.AttributeTargets.Class)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Security.SecurityCritical>]
type SynchronizationAttribute = class
    inherit ContextAttribute
    interface IContributeServerContextSink
    interface IContributeClientContextSink

Public Class SynchronizationAttribute
Inherits ContextAttribute
Implements IContributeClientContextSink, IContributeServerContextSink

Héritage

Object

Attribute

ContextAttribute

SynchronizationAttribute

Attributs

AttributeUsageAttribute SerializableAttribute ComVisibleAttribute SecurityCriticalAttribute

Implémente

IContributeClientContextSink IContributeServerContextSink

Exemples

L’exemple de code suivant illustre l’utilisation du SynchronizationAttribute. Pour obtenir l’exemple de code complet, consultez l’exemple de la AsyncResult classe.

// Context-bound type with the Synchronization context attribute.

[Synchronization]
public ref class SampleSynchronized: public ContextBoundObject
{
public:

   // A method that does some work, and returns the square of the given number.
   int Square( int i )
   {
      Console::Write( "The hash of the thread executing " );
      Console::WriteLine( "SampleSynchronized::Square is: {0}", Thread::CurrentThread->GetHashCode() );
      return i * i;
   }

};

// Context-bound type with the Synchronization context attribute.
[Synchronization()]
public class SampleSynchronized : ContextBoundObject {

    // A method that does some work, and returns the square of the given number.
    public int Square(int i)  {

        Console.Write("The hash of the thread executing ");
        Console.WriteLine("SampleSynchronized.Square is: {0}",
                             Thread.CurrentThread.GetHashCode());
        return i*i;
    }
}

' Context-bound type with the Synchronization context attribute.
<Synchronization()> Public Class SampleSynchronized
   Inherits ContextBoundObject
   
   ' A method that does some work, and returns the square of the given number.
   Public Function Square(i As Integer) As Integer
      
      Console.Write("The hash of the thread executing ")
      Console.WriteLine("SampleSynchronized.Square is: {0}", Thread.CurrentThread.GetHashCode())
      Return i * i
   End Function 

End Class

Remarques

Lorsque cet attribut est appliqué à un objet, un seul thread peut s’exécuter dans tous les contextes qui partagent une instance de cette propriété. Cela s’effectue en contribuant aux récepteurs qui interceptent et sérialisent les appels entrants pour les contextes respectifs. Si la propriété est marquée pour la réenterie, les légendes sont également interceptées. L’interception de légende permet à d’autres threads en attente d’entrer dans le domaine de synchronisation pour un débit maximal.

Note

Il existe deux classes nommées SynchronizationAttribute : une dans l’espace System.Runtime.Remoting.Contexts de noms et l’autre dans l’espace System.EnterpriseServices de noms. La System.EnterpriseServices.SynchronizationAttribute classe prend uniquement en charge les appels synchrones et peut être utilisée uniquement avec les composants serviced. Les System.Runtime.Remoting.Contexts.SynchronizationAttribute appels synchrones et asynchrones sont pris en charge et peuvent être utilisés uniquement avec des objets liés au contexte. (Pour plus d’informations sur les objets liés au contexte, consultez la ContextBoundObject classe.)

Note

Cette classe effectue une demande de liaison et une demande d’héritage au niveau de la classe. A SecurityException est levée lorsque l’appelant immédiat ou la classe dérivée n’a pas d’autorisation d’infrastructure. Pour plus d’informations sur les demandes de sécurité, consultez Demandes de liaison.

Constructeurs

Nom	Description
SynchronizationAttribute()	Initialise une nouvelle instance de la SynchronizationAttribute classe avec des valeurs par défaut.
SynchronizationAttribute(Boolean)	Initialise une nouvelle instance de la SynchronizationAttribute classe avec une valeur booléenne indiquant si une nouvelle entrée est requise.
SynchronizationAttribute(Int32, Boolean)	Initialise une nouvelle instance de la SynchronizationAttribute classe avec un indicateur indiquant le comportement de l’objet auquel cet attribut est appliqué, et une valeur booléenne indiquant si la réentrage est requise.
SynchronizationAttribute(Int32)	Initialise une nouvelle instance de la SynchronizationAttribute classe avec un indicateur indiquant le comportement de l’objet auquel cet attribut est appliqué.

Champs

Nom	Description
AttributeName	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Indique le nom de l’attribut de contexte. (Hérité de ContextAttribute)
NOT_SUPPORTED	Indique que la classe à laquelle cet attribut est appliqué ne peut pas être créée dans un contexte qui a la synchronisation. Ce champ est constant.
REQUIRED	Indique que la classe à laquelle cet attribut est appliqué doit être créée dans un contexte qui a la synchronisation. Ce champ est constant.
REQUIRES_NEW	Indique que la classe à laquelle cet attribut est appliqué doit être créée dans un contexte avec une nouvelle instance de la propriété de synchronisation à chaque fois. Ce champ est constant.
SUPPORTED	Indique que la classe à laquelle cet attribut est appliqué n’est pas dépendante de la synchronisation du contexte. Ce champ est constant.

Propriétés

Nom	Description
IsReEntrant	Obtient ou définit une valeur booléenne indiquant si la réentration est requise.
Locked	Obtient ou définit une valeur booléenne indiquant si l’implémentation Context de cette instance est SynchronizationAttribute verrouillée.
Name	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient le nom de l’attribut de contexte. (Hérité de ContextAttribute)
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

Méthodes

Nom	Description
Equals(Object)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Retourne une valeur booléenne indiquant si cette instance est égale à l’objet spécifié. (Hérité de ContextAttribute)
Freeze(Context)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Appelé lorsque le contexte est figé. (Hérité de ContextAttribute)
GetClientContextSink(IMessageSink)	Crée un récepteur CallOut et le chaîne devant la chaîne fournie de récepteurs au niveau de la limite de contexte à la fin du client d’un appel de communication à distance.
GetHashCode()	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Retourne le code de hachage pour cette instance de ContextAttribute. (Hérité de ContextAttribute)
GetPropertiesForNewContext(IConstructionCallMessage)	Ajoute la Synchronized propriété de contexte à l’objet spécifié IConstructionCallMessage.
GetServerContextSink(IMessageSink)	Crée un récepteur de répartition synchronisé et le chaîne devant la chaîne fournie de récepteurs au niveau de la limite de contexte sur la fin du serveur d’un appel de communication à distance.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsContextOK(Context, IConstructionCallMessage)	Retourne une valeur booléenne indiquant si le paramètre de contexte répond aux exigences de l’attribut de contexte.
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute)
IsNewContextOK(Context)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Retourne une valeur booléenne indiquant si la propriété de contexte est compatible avec le nouveau contexte. (Hérité de ContextAttribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute)