ApartmentState 列挙体とは何？わかりやすく解説 Weblio辞書

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

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

ApartmentState 列挙体

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

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration ApartmentState

Visual Basic (使用法)

Dim instance As ApartmentState

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum ApartmentState

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class ApartmentState

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum ApartmentState

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum ApartmentState

メンバ

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

解説

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

COM クラスはアパートメントを使用するため、共通言語ランタイムでは、COM 相互運用状況で COM オブジェクトを呼び出すときにアパートメントを作成および初期化する必要があります。マネージスレッドでは、1 つのスレッドだけを格納できるシングルスレッドアパートメント (STA: single-threaded apartment)、または 1 つ以上のスレッドを格納するマルチスレッドアパートメント (MTA: multithreaded apartment) を作成および入力できます。作成するアパートメントの種類を制御するには、スレッドの ApartmentState プロパティを ApartmentState 列挙体の値の 1 つに設定します。1 つのスレッドでは COM アパートメントを一度しか初期化できないため、アンマネージコードを一度呼び出すと、アパートメントの種類は変更できません。

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

使用例

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

Visual Basic

Imports Microsoft.VisualBasic
Imports System
Imports System.Threading

Public Class ApartmentTest

    <MTAThread> _
    Shared Sub Main()
    
        Dim newThread As Thread = New
 Thread(AddressOf ThreadMethod)
        newThread.SetApartmentState(ApartmentState.MTA)

        ' The following line is ignored since 
        ' ApartmentState can only be set once.
        newThread.SetApartmentState(ApartmentState.STA)

        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 stateException As ThreadStateException
            Console.WriteLine(vbCrLf & "{0} caught:"
 & vbCrLf & _
                "Thread is not In the Unstarted or Running state.",
 _
                stateException.GetType().Name)
            Console.WriteLine("ThreadState: {0}, ApartmentState:
 " & _
                "{1}", newThread.ThreadState, newThread.GetApartmentState())
        End Try

    End Sub

    Shared Sub ThreadMethod()
        Thread.Sleep(1000)
    End Sub

End Class

using System;
using System.Threading;

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

        // The following line is ignored since 
        // ApartmentState can only be set once.
        newThread.SetApartmentState(ApartmentState.STA);

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

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

C++

using namespace System;
using namespace System::Threading;
ref class ApartmentTest
{
public:
   static void ThreadMethod()
   {
      Thread::Sleep( 1000 );
   }

};

int main()
{
   Thread^ newThread = gcnew Thread( gcnew ThreadStart( &ApartmentTest::ThreadMethod
 ) );
   newThread->SetApartmentState(ApartmentState::MTA);
   
   // The following line is ignored since 
   // ApartmentState can only be set once.
   newThread->SetApartmentState(ApartmentState::STA);
   Console::WriteLine( "ThreadState: {0}, ApartmentState: {1}", newThread->ThreadState.ToString(),
 newThread->GetApartmentState().ToString() );
   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.ToString(),
 newThread->GetApartmentState().ToString() );
   }

}

import System.*;
import System.Threading.*;
import System.Threading.Thread;    

class ApartmentTest
{
    public static void main(String[]
 args)
    {
        Thread newThread = new Thread(new ThreadStart(ThreadMethod));

        newThread.set_ApartmentState(ApartmentState.MTA);

        // The following line is ignored since 
        // ApartmentState can only be set once.
        newThread.set_ApartmentState(ApartmentState.STA);
        Console.WriteLine("ThreadState: {0}, ApartmentState: {1}",
                        newThread.get_ThreadState(),
                        newThread.get_ApartmentState());
        newThread.Start();

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
System.Threading 名前空間
Thread
その他の技術情報
マネージスレッドとアンマネージスレッド
高度な COM 相互運用性

>> 「ApartmentState 列挙体」を含む用語の索引
ApartmentState 列挙体のページへのリンク


	© 2024 Microsoft.All rights reserved.

ApartmentState 列挙体とは？ わかりやすく解説

ApartmentState 列挙体

急上昇のことば

ApartmentState 列挙体とは？わかりやすく解説