SynchronizationAttribute-Klasse

Erzwingt eine Synchronisierungsdomäne für den aktuellen Kontext und alle Kontexte, die dieselbe Instanz gemeinsam nutzen.

Namespace: System.Runtime.Remoting.Contexts
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Class)> _
<ComVisibleAttribute(True)> _
Public Class SynchronizationAttribute
    Inherits ContextAttribute
    Implements IContributeServerContextSink, IContributeClientContextSink
'Usage
Dim instance As SynchronizationAttribute

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets.Class)] 
[ComVisibleAttribute(true)] 
public class SynchronizationAttribute : ContextAttribute, IContributeServerContextSink, IContributeClientContextSink

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets::Class)] 
[ComVisibleAttribute(true)] 
public ref class SynchronizationAttribute : public ContextAttribute, IContributeServerContextSink, IContributeClientContextSink

/** @attribute SerializableAttribute() */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class SynchronizationAttribute extends ContextAttribute implements IContributeServerContextSink, IContributeClientContextSink

SerializableAttribute 
AttributeUsageAttribute(AttributeTargets.Class) 
ComVisibleAttribute(true) 
public class SynchronizationAttribute extends ContextAttribute implements IContributeServerContextSink, IContributeClientContextSink

Hinweise

Wenn dieses Attribut auf ein Objekt angewendet wird, kann in allen Kontexten, die eine Instanz dieser Eigenschaft gemeinsam nutzen, nur ein Thread ausgeführt werden. Dies wird dadurch erreicht, dass Empfänger bereitgestellt werden, die eingehende Aufrufe für die jeweiligen Kontexte abfangen und serialisieren. Wenn Reentranz für die Eigenschaft markiert ist, werden ausgehende Aufrufe ebenfalls abgefangen. Durch das Abfangen von ausgehenden Aufrufen wird es anderen wartenden Threads ermöglicht, in die Synchronisierungsdomäne einzutreten, um einen maximalen Durchsatz zu erreichen.

Beispiel

Im folgenden Codebeispiel wird die Verwendung von SynchronizationAttribute veranschaulicht. Den vollständigen Beispielcode finden Sie im Beispiel zur AsyncResult-Klasse.

' Context-bound type with the Synchronization context attribute.
<Synchronization()> Public Class SampleSyncronized
   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("SampleSyncronized.Square is: {0}", Thread.CurrentThread.GetHashCode())
      Return i * i
   End Function 'Square

End Class 'SampleSyncronized

// Context-bound type with the Synchronization context attribute.
[Synchronization()]
public class SampleSyncronized : 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("SampleSyncronized.Square is: {0}", 
                             Thread.CurrentThread.GetHashCode());
        return i*i;
    }
}

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

[Synchronization]
public ref class SampleSyncronized: 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( "SampleSyncronized::Square is: {0}", Thread::CurrentThread->GetHashCode() );
      return i * i;
   }

};

// Context-bound type with the Synchronization context attribute.
/** @attribute Synchronization()
 */
public class SampleSyncronized extends 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("SampleSyncronized.Square is: {0}",
            (Int32)System.Threading.Thread.get_CurrentThread().GetHashCode());
        return i * i;
    } //Square
} //SampleSyncronized

.NET Framework-Sicherheit

• SecurityPermission  für die Verwendung von Infrastrukturcode. Anforderungswert: SecurityAction.LinkDemand; Berechtigungswert: SecurityPermissionFlag.Infrastructure
• SecurityPermission  für die Verwendung von Infrastrukturcode. Anforderungswert: SecurityAction.InheritanceDemand; Berechtigungswert: SecurityPermissionFlag.Infrastructure

Vererbungshierarchie

System.Object
   System.Attribute
     System.Runtime.Remoting.Contexts.ContextAttribute
      System.Runtime.Remoting.Contexts.SynchronizationAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SynchronizationAttribute-Member
System.Runtime.Remoting.Contexts-Namespace