ApartmentState 列舉

定義

命名空間:

System.Threading

組件:

netstandard.dll, System.Threading.Thread.dll

來源:

ApartmentState.cs

指定 Thread的 Apartment 狀態。

public enum class ApartmentState

public enum ApartmentState

type ApartmentState = 

Public Enum ApartmentState

繼承

Object

ValueType

Enum

ApartmentState

欄位

名稱	值	Description
STA	0	它們 Thread 會建立並進入一個單線公寓。
MTA	1	他們 Thread 會建立並進入多執行緒公寓。
Unknown	2	ApartmentState該物業尚未設定。

範例

以下程式碼範例示範如何設定執行緒的公寓狀態。

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

}

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

Imports System.Threading

Public Class ApartmentTest

    <MTAThread> _
    Shared Sub Main()
    
        Dim newThread As Thread = New Thread(AddressOf 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 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

備註

公寓是程序中用於物件共享相同執行緒存取需求的邏輯容器。 同一公寓內的所有物件都可以接收來自公寓內任何執行緒的呼叫。 .NET Framework 不使用 apartments，受管理物件負責以執行緒安全的方式使用所有共享資源。

由於 COM 類別使用 apartments，公共語言執行環境在 COM 互操作情境中呼叫 COM 物件時，需要建立並初始化 apartment。 受管理執行緒可以建立並進入只允許一個執行緒的單執行緒公寓（STA），或包含一個或多個執行緒的多執行緒公寓（MTA）。 你可以透過將執行緒的屬性設定 ApartmentState 為列舉值 ApartmentState 之一來控制所建立的公寓類型。 因為每個執行緒只能初始化一次 COM 公寓，所以在第一次呼叫非管理程式碼後，你無法更改公寓類型。

欲了解更多資訊，請參閱Thread「受管與非管理執行緒」及「進階 COM 互通性」。

另請參閱

• Thread