Thread.TrySetApartmentState(ApartmentState) Metoda

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.Thread.dll

Zestaw:

netstandard.dll

Zestaw:

mscorlib.dll

Ustawia stan chłoniaka wątku przed jego rozpoczęciem.

public:
 bool TrySetApartmentState(System::Threading::ApartmentState state);

public bool TrySetApartmentState (System.Threading.ApartmentState state);

member this.TrySetApartmentState : System.Threading.ApartmentState -> bool

Public Function TrySetApartmentState (state As ApartmentState) As Boolean

Parametry

state

ApartmentState

Nowy stan chłoniaka.

Zwraca

Boolean

true jeśli stan chłoniaka jest ustawiony; w przeciwnym razie false .

Wyjątki

PlatformNotSupportedException

Tylko .NET Core i .NET 5+: we wszystkich przypadkach w systemach macOS i Linux.

ArgumentException

state nie jest prawidłowym stanem chłoniaka.

ThreadStateException

Wątek został uruchomiony i został zakończony lub wywołanie nie jest wykonane z kontekstu wątku, gdy wątek jest uruchomiony.

Przykłady

W poniższym przykładzie kodu pokazano GetApartmentState metody SetApartmentState , i TrySetApartmentState . Przykładowy kod tworzy wątek. Przed rozpoczęciem wątku wyświetla GetApartmentState stan początkowy i zmienia stan na ApartmentState.Unknown SetApartmentState ApartmentState.STA . Następnie metoda zwraca wartość podczas próby zmiany stanu na , ponieważ TrySetApartmentState false stan ApartmentState.MTA chłoniaka jest już ustawiony. Jeśli ta sama operacja zostałaby podjętoby próbę SetApartmentState z , InvalidOperationException zostałby zgłoszony.

Po zakończeniu wątku ponownie TrySetApartmentState używana jest metoda . Tym razem zgłasza ThreadStateException wyjątek, ponieważ wątek został już uruchomiony.

using namespace System;
using namespace System::Threading;

void ThreadProc()
{
    Thread::Sleep(2000);
};

void main()
{
    Thread^ t = gcnew Thread(gcnew ThreadStart(ThreadProc));
    Console::WriteLine("Before setting apartment state: {0}", 
            t->GetApartmentState());

    t->SetApartmentState(ApartmentState::STA);
    Console::WriteLine("After setting apartment state: {0}", 
        t->GetApartmentState());

    bool result = t->TrySetApartmentState(ApartmentState::MTA);
    Console::WriteLine("Try to change state: {0}", result);

    t->Start();

    Thread::Sleep(500);

    try
    {
        t->TrySetApartmentState(ApartmentState::STA);
    }
    catch (ThreadStateException^)
    {
        Console::WriteLine("ThreadStateException occurs " +
            "if apartment state is set after starting thread.");
    }

    t->Join();
}

/* This code example produces the following output:

Before setting apartment state: Unknown
After setting apartment state: STA
Try to change state: False
ThreadStateException occurs if apartment state is set after starting thread.
 */

using System;
using System.Threading;

class Example
{
    public static void Main()
    {
        Thread t = new Thread(ThreadProc);
        Console.WriteLine("Before setting apartment state: {0}",
            t.GetApartmentState());

        t.SetApartmentState(ApartmentState.STA);
        Console.WriteLine("After setting apartment state: {0}",
            t.GetApartmentState());

        bool result = t.TrySetApartmentState(ApartmentState.MTA);
        Console.WriteLine("Try to change state: {0}", result);

        t.Start();

        Thread.Sleep(500);

        try
        {
            t.TrySetApartmentState(ApartmentState.STA);
        }
        catch (ThreadStateException)
        {
            Console.WriteLine("ThreadStateException occurs " +
                "if apartment state is set after starting thread.");
        }

        t.Join();
    }

    public static void ThreadProc()
    {
        Thread.Sleep(2000);
    }
}

/* This code example produces the following output:

Before setting apartment state: Unknown
After setting apartment state: STA
Try to change state: False
ThreadStateException occurs if apartment state is set after starting thread.
 */

Imports System.Threading

Module Example

    Sub Main()
 
        Dim t As New Thread(AddressOf ThreadProc)
        Console.WriteLine("Before setting apartment state: {0}", _
            t.GetApartmentState())

        t.SetApartmentState(ApartmentState.STA)
        Console.WriteLine("After setting apartment state: {0}", _
            t.GetApartmentState())

        Dim result As Boolean = _
            t.TrySetApartmentState(ApartmentState.MTA)
        Console.WriteLine("Try to change state: {0}", result)

        t.Start()

        Thread.Sleep(500)

        Try
            t.TrySetApartmentState(ApartmentState.STA)
        Catch ex As ThreadStateException
            Console.WriteLine("ThreadStateException occurs " & _
                "if apartment state is set after starting thread.")
        End Try

        t.Join()
    End Sub

    Sub ThreadProc()
        Thread.Sleep(2000)
    End Sub
End Module

' This code example produces the following output:
'
'Before setting apartment state: Unknown
'After setting apartment state: STA
'Try to change state: False
'ThreadStateException occurs if apartment state is set after starting thread.

Uwagi

Nowe wątki są inicjowane tak, jakby ich stan na pępce nie ApartmentState.MTA został ustawiony przed rozpoczęciem. Stan cyka musi zostać ustawiony przed rozpoczęciem wątku.

Uwaga

Główny wątek aplikacji jest domyślnie ApartmentState.MTA zainicjowany w programie . Jedynym sposobem ustawienia stanu chłoniaka głównego wątku aplikacji jest zastosowanie atrybutu ApartmentState.STA STAThreadAttribute do metody punktu wejścia.

Metoda wraz z metodą i zastępuje TrySetApartmentState GetApartmentState właściwość SetApartmentState ApartmentState .