SynchronizationAttribute クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SynchronizationAttribute クラス

コンポーネントの同期値を設定します。このクラスは継承できません。

名前空間: System.EnterpriseServices
アセンブリ: System.EnterpriseServices (system.enterpriseservices.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
<AttributeUsageAttribute(AttributeTargets.Class, Inherited:=True)> _
Public NotInheritable Class
 SynchronizationAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As SynchronizationAttribute

[ComVisibleAttribute(false)] 
[AttributeUsageAttribute(AttributeTargets.Class, Inherited=true)]
 
public sealed class SynchronizationAttribute
 : Attribute

C++

[ComVisibleAttribute(false)] 
[AttributeUsageAttribute(AttributeTargets::Class, Inherited=true)]
 
public ref class SynchronizationAttribute sealed
 : public Attribute

/** @attribute ComVisibleAttribute(false) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Class, Inherited=true)
 */ 
public final class SynchronizationAttribute
 extends Attribute

JScript

ComVisibleAttribute(false) 
AttributeUsageAttribute(AttributeTargets.Class, Inherited=true)
 
public final class SynchronizationAttribute
 extends Attribute

解説

同期はトランザクションとジャストインタイム (JIT: Just-In-Time) の両方のアクティベーションによって自動的に有効になります。

属性の使用方法については、「属性を使用したメタデータの拡張」を参照してください。

SynchronizationAttribute をコンテキストバインドオブジェクトに適用すると、待機ハンドルと自動リセットイベントが作成されます。この待機ハンドルと自動リセットイベントは、ガベージコレクションで収集されないことがあります。したがって、短期間に SynchronizationAttribute でマークされたコンテキストバインドオブジェクトを大量に作成しないでください。

使用例

SynchronizationAttribute 型の使用方法のコード例を次に示します。

Visual Basic

Imports System
Imports System.EnterpriseServices
Imports System.Reflection


' References:
' System.EnterpriseServices

' This is equivalent to [Synchronization(SynchronizationOption.Required)].
<Synchronization()>  _
Public Class SynchronizationAttribute_Ctor
    Inherits ServicedComponent
End Class 'SynchronizationAttribute_Ctor

<Synchronization(SynchronizationOption.Disabled)>  _
Public Class SynchronizationAttribute_Ctor_SynchronizationOption
    Inherits ServicedComponent
End Class 'SynchronizationAttribute_Ctor_SynchronizationOption

<Synchronization(SynchronizationOption.RequiresNew)>  _
Public Class SynchronizationAttribute_Value
    Inherits ServicedComponent
    
    Public Sub ValueExample() 
        ' Get the SynchronizationAttribute applied to the class.
        Dim attribute As SynchronizationAttribute
 = CType(Attribute.GetCustomAttribute(Me.GetType(), GetType(SynchronizationAttribute),
 False), SynchronizationAttribute)
        
        ' Display the value of the attribute's Value property.
        MsgBox("SynchronizationAttribute.Value: "
 & attribute.Value)
    
    End Sub 'ValueExample
End Class 'SynchronizationAttribute_Value

using System;
using System.EnterpriseServices;
using System.Reflection;

// References:
// System.EnterpriseServices

// This is equivalent to [Synchronization(SynchronizationOption.Required)].
[Synchronization]
public class SynchronizationAttribute_Ctor
 : ServicedComponent
{
}

[Synchronization(SynchronizationOption.Disabled)]
public class SynchronizationAttribute_Ctor_SynchronizationOption
 : ServicedComponent
{
}

[Synchronization(SynchronizationOption.RequiresNew)]
public class SynchronizationAttribute_Value
 : ServicedComponent
{
    public void ValueExample()
    {
        // Get the SynchronizationAttribute applied to the class.
        SynchronizationAttribute attribute =
            (SynchronizationAttribute)Attribute.GetCustomAttribute(
            this.GetType(),
            typeof(SynchronizationAttribute),
            false);

        // Display the value of the attribute's Value property.
        Console.WriteLine("SynchronizationAttribute.Value: {0}",
            attribute.Value);
    }
}

import System.*;
import System.EnterpriseServices.*;
import System.Reflection.*;

// References:
// System.EnterpriseServices

// This is equivalent to [Synchronization(SynchronizationOption.Required)].
/** @attribute Synchronization()
 */
public class SynchronizationAttribute_Ctor
 extends ServicedComponent
{
} //SynchronizationAttribute_Ctor

/** @attribute Synchronization(SynchronizationOption.Disabled)
 */
public class SynchronizationAttribute_Ctor_SynchronizationOption
 
    extends ServicedComponent
{
} //SynchronizationAttribute_Ctor_SynchronizationOption

/** @attribute Synchronization(SynchronizationOption.RequiresNew)
 */
public class SynchronizationAttribute_Value
 extends ServicedComponent
{
    public void ValueExample()
    {
        // Get the SynchronizationAttribute applied to the class.
        SynchronizationAttribute attribute = (SynchronizationAttribute)(
            Attribute.GetCustomAttribute(this.GetType(),
            SynchronizationAttribute.class.ToType(), false));

        // Display the value of the attribute's Value property.
        Console.WriteLine("SynchronizationAttribute.Value: {0}",
            attribute.get_Value());
    } //ValueExample
} //SynchronizationAttribute_Value

継承階層

System.Object
System.Attribute
System.EnterpriseServices.SynchronizationAttribute

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SynchronizationAttribute メンバ
System.EnterpriseServices 名前空間

SynchronizationAttribute クラス

現在のコンテキスト、および同じインスタンスを共有するすべてのコンテキストの同期ドメインを適用します。

名前空間: System.Runtime.Remoting.Contexts
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Class)> _
<ComVisibleAttribute(True)> _
Public Class SynchronizationAttribute
    Inherits ContextAttribute
    Implements IContributeServerContextSink, IContributeClientContextSink

Visual Basic (使用法)

Dim instance As SynchronizationAttribute

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

C++

[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

JScript

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

解説

この属性をオブジェクトに適用する場合、このプロパティのインスタンスを共有するすべてのコンテキスト内で実行できるスレッドは 1 つだけです。それぞれのコンテキストの着信呼び出しを受け取り、シリアル化するシンクを提供することによって実行されます。プロパティが再エントリとしてマークされている場合は、コールアウトも受け取られます。コールアウトを受け取ることにより、待機している他のスレッドが同期ドメインに参加できるようになり、最大限のスループットを実現できます。

メモ
SynchronizationAttribute という名前のクラスが 2 つあります。1 つは System.Runtime.Remoting.Contexts 名前空間に格納され、もう 1 つは System.EnterpriseServices 名前空間に格納されています。System.EnterpriseServices.SynchronizationAttribute クラスは、同期呼び出しだけをサポートし、サービスコンポーネントだけで使用できます。サービスコンポーネントの詳細については、「サービスコンポーネントの概要」を参照してください。System.Runtime.Remoting.Contexts.SynchronizationAttribute は、同期呼び出しおよび非同期呼び出しをサポートし、コンテキストバインドオブジェクトだけで使用できます。コンテキストバインドオブジェクトの詳細については ContextBoundObject クラスのトピックを参照してください。

メモ

SynchronizationAttribute という名前のクラスが 2 つあります。1 つは System.Runtime.Remoting.Contexts 名前空間に格納され、もう 1 つは System.EnterpriseServices 名前空間に格納されています。System.EnterpriseServices.SynchronizationAttribute クラスは、同期呼び出しだけをサポートし、サービスコンポーネントだけで使用できます。サービスコンポーネントの詳細については、「サービスコンポーネントの概要」を参照してください。System.Runtime.Remoting.Contexts.SynchronizationAttribute は、同期呼び出しおよび非同期呼び出しをサポートし、コンテキストバインドオブジェクトだけで使用できます。コンテキストバインドオブジェクトの詳細については ContextBoundObject クラスのトピックを参照してください。

メモ
このクラスは、リンク確認要求と継承確認要求をクラスレベルで行います。直前の呼び出し元または派生クラスにインフラストラクチャアクセス許可がない場合、SecurityException がスローされます。セキュリティ要求の詳細については、「リンク確認要求」および「継承確認要求」を参照してください。

メモ

このクラスは、リンク確認要求と継承確認要求をクラスレベルで行います。直前の呼び出し元または派生クラスにインフラストラクチャアクセス許可がない場合、SecurityException がスローされます。セキュリティ要求の詳細については、「リンク確認要求」および「継承確認要求」を参照してください。

使用例

SynchronizationAttribute の使用方法については、次のコード例を参照してください。プログラム例の全体については、AsyncResult クラスのトピックの例を参照してください。

Visual Basic

' 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;
    }
}

C++

// 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 のセキュリティ

SecurityPermission (インフラストラクチャコードを操作するために必要なアクセス許可)。要求値 : SecurityAction.LinkDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure
SecurityPermission (インフラストラクチャコードを操作するために必要なアクセス許可)。要求値 : SecurityAction.InheritanceDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure

継承階層

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

スレッドセーフ