ApartmentState Enumerazione

  • Riferimento

Definizione

Spazio dei nomi:
System.Threading
Assembly:
System.Threading.Thread.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Specifica lo stato dell'apartment di un Thread.

public enum class ApartmentState
public enum ApartmentState
[System.Serializable]
public enum ApartmentState
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ApartmentState
type ApartmentState = 
[<System.Serializable>]
type ApartmentState = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ApartmentState = 
Public Enum ApartmentState
Ereditarietà
Object
ValueType
Enum
ApartmentState
Attributi
SerializableAttribute ComVisibleAttribute

Campi

MTA 1

Thread creerà ed immetterà un apartment con multithreading.
STA 0

Thread creerà ed immetterà un apartment a thread singolo.
Unknown 2

La proprietà ApartmentState non è stata impostata.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare lo stato apartment di un thread.

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

Commenti

Un apartment è un contenitore logico all'interno di un processo per gli oggetti che condividono gli stessi requisiti di accesso ai thread. Tutti gli oggetti nello stesso appartamento possono ricevere chiamate da qualsiasi thread nell'appartamento. Il .NET Framework non utilizza appartamenti e gli oggetti gestiti sono responsabili dell'uso di tutte le risorse condivise in modo thread-safe.

Poiché le classi COM usano appartamenti, Common Language Runtime deve creare e inizializzare un apartment quando si chiama un oggetto COM in una situazione di interoperabilità COM. Un thread gestito può creare e immettere un apartment a thread singolo (STA) che consente un solo thread o un apartment multithreading (MTA) che contiene uno o più thread. È possibile controllare il tipo di apartment creato impostando la ApartmentState proprietà del thread su uno dei valori dell'enumerazione ApartmentState . Poiché un determinato thread può inizializzare un apartment COM una sola volta, non è possibile modificare il tipo di apartment dopo la prima chiamata al codice non gestito.

Per altre informazioni, vedere Thread, Threading gestito e non gestito e Interoperabilità COM avanzata.

Si applica a

Vedi anche