ApartmentState 列挙型

定義

名前空間:

System.Threading

アセンブリ:

System.Threading.Thread.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

Thread のアパートメント状態を指定します。

C#

public enum ApartmentState

C#

[System.Serializable]
public enum ApartmentState

C#

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ApartmentState

継承

Object

ValueType

Enum

ApartmentState

属性

SerializableAttribute ComVisibleAttribute

フィールド

MTA	1	Thread は、マルチスレッド アパートメントを作成および入力します。
STA	0	Thread は、シングルスレッド アパートメントを作成および入力します。
Unknown	2	ApartmentState プロパティが設定されていません。

例

次のコード例は、スレッドのアパートメント状態を設定する方法を示しています。

C#

using System;
using System.Threading;

class ApartmentTest
{
    static void Main()
    {
        Thread newThread = 
            new Thread(new ThreadStart(ThreadMethod));
        newThread.SetApartmentState(ApartmentState.MTA);

        Console.WriteLine("ThreadState: {0}, ApartmentState: {1}", 
            newThread.ThreadState, newThread.GetApartmentState());

        newThread.Start();

        // Wait for newThread to start and go to sleep.
        Thread.Sleep(300);
        try
        {
            // This causes an exception since newThread is sleeping.
            newThread.SetApartmentState(ApartmentState.STA);
        }
        catch(ThreadStateException stateException)
        {
            Console.WriteLine("\n{0} caught:\n" +
                "Thread is not in the Unstarted or Running state.", 
                stateException.GetType().Name);
            Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
                newThread.ThreadState, newThread.GetApartmentState());
        }
    }

    static void ThreadMethod()
    {
        Thread.Sleep(1000);
    }
}

注釈

アパートメントは、同じスレッド アクセス要件を共有するオブジェクトのプロセス内の論理コンテナーです。 同じアパートメント内のすべてのオブジェクトは、アパートメント内の任意のスレッドから呼び出しを受け取ることができます。 .NET Frameworkではアパートメントは使用されず、マネージド オブジェクトはスレッド セーフな方法ですべての共有リソースを使用する必要があります。

COM クラスはアパートメントを使用するため、共通言語ランタイムは、COM 相互運用状況で COM オブジェクトを呼び出すときにアパートメントを作成して初期化する必要があります。 マネージド スレッドは、1 つのスレッドのみを許可するシングル スレッド アパートメント (STA) または 1 つ以上のスレッドを含むマルチスレッド アパートメント (MTA) を作成して入力できます。 スレッドのプロパティを列挙の値の 1 つに設定 ApartmentState することで、作成されたアパートメントの種類を ApartmentState 制御できます。 特定のスレッドは COM アパートメントを 1 回だけ初期化できるため、アンマネージ コードの最初の呼び出し後にアパートメントの種類を変更することはできません。

詳細については、「Threadマネージド スレッドとアンマネージド スレッド」および「高度な COM 相互運用性」を参照してください。

適用対象

こちらもご覧ください

• Thread