AutoResetEvent Classe

Definição

Namespace:

System.Threading

Assembly:

System.Threading.dll

Origem:

AutoResetEvent.cs

Representa um evento de sincronização de thread que, quando sinalizado, libera um único thread de espera e, em seguida, redefine automaticamente. Essa classe não pode ser herdada.

public ref class AutoResetEvent sealed : System::Threading::EventWaitHandle

public sealed class AutoResetEvent : System.Threading.EventWaitHandle

type AutoResetEvent = class
    inherit EventWaitHandle

Public NotInheritable Class AutoResetEvent
Inherits EventWaitHandle

Herança

Object

MarshalByRefObject

WaitHandle

EventWaitHandle

AutoResetEvent

Exemplos

O exemplo a seguir mostra como usar AutoResetEvent para liberar um thread de cada vez, chamando o método Set (na classe base) sempre que o usuário pressiona a tecla Enter. O exemplo inicia três threads, que esperam em um AutoResetEvent que foi criado no estado sinalizado. O primeiro thread é liberado imediatamente, pois o AutoResetEvent já está no estado sinalizado. Isso redefine o AutoResetEvent para o estado não sinalizado, de modo que os threads subsequentes bloqueiem. Os threads bloqueados não são liberados até que o usuário os libere um de cada vez pressionando o Enter chave.

Depois que os threads forem liberados do primeiro AutoResetEvent, eles aguardarão outro AutoResetEvent que foi criado no estado não sinalizado. Todos os três threads bloqueiam, portanto, o método Set deve ser chamado três vezes para liberá-los todos.

using namespace System;
using namespace System::Threading;

ref class Example
{
private:
    static AutoResetEvent^ event_1 = gcnew AutoResetEvent(true);
    static AutoResetEvent^ event_2 = gcnew AutoResetEvent(false);

    static void ThreadProc()
    {
        String^ name = Thread::CurrentThread->Name;

        Console::WriteLine("{0} waits on AutoResetEvent #1.", name);
        event_1->WaitOne();
        Console::WriteLine("{0} is released from AutoResetEvent #1.", name);

        Console::WriteLine("{0} waits on AutoResetEvent #2.", name);
        event_2->WaitOne();
        Console::WriteLine("{0} is released from AutoResetEvent #2.", name);

        Console::WriteLine("{0} ends.", name);
    }

public:
    static void Demo()
    {
        Console::WriteLine("Press Enter to create three threads and start them.\r\n" +
                           "The threads wait on AutoResetEvent #1, which was created\r\n" +
                           "in the signaled state, so the first thread is released.\r\n" +
                           "This puts AutoResetEvent #1 into the unsignaled state.");
        Console::ReadLine();
            
        for (int i = 1; i < 4; i++)
        {
            Thread^ t = gcnew Thread(gcnew ThreadStart(&ThreadProc));
            t->Name = "Thread_" + i;
            t->Start();
        }
        Thread::Sleep(250);

        for (int i = 0; i < 2; i++)
        {
            Console::WriteLine("Press Enter to release another thread.");
            Console::ReadLine();
            event_1->Set();
            Thread::Sleep(250);
        }

        Console::WriteLine("\r\nAll threads are now waiting on AutoResetEvent #2.");
        for (int i = 0; i < 3; i++)
        {
            Console::WriteLine("Press Enter to release a thread.");
            Console::ReadLine();
            event_2->Set();
            Thread::Sleep(250);
        }

        // Visual Studio: Uncomment the following line.
        //Console::Readline();
    }
};

void main()
{
    Example::Demo();
}

/* This example produces output similar to the following:

Press Enter to create three threads and start them.
The threads wait on AutoResetEvent #1, which was created
in the signaled state, so the first thread is released.
This puts AutoResetEvent #1 into the unsignaled state.

Thread_1 waits on AutoResetEvent #1.
Thread_1 is released from AutoResetEvent #1.
Thread_1 waits on AutoResetEvent #2.
Thread_3 waits on AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #1.
Press Enter to release another thread.

Thread_3 is released from AutoResetEvent #1.
Thread_3 waits on AutoResetEvent #2.
Press Enter to release another thread.

Thread_2 is released from AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #2.

All threads are now waiting on AutoResetEvent #2.
Press Enter to release a thread.

Thread_2 is released from AutoResetEvent #2.
Thread_2 ends.
Press Enter to release a thread.

Thread_1 is released from AutoResetEvent #2.
Thread_1 ends.
Press Enter to release a thread.

Thread_3 is released from AutoResetEvent #2.
Thread_3 ends.
 */

using System;
using System.Threading;

// Visual Studio: Replace the default class in a Console project with 
//                the following class.
class Example
{
    private static AutoResetEvent event_1 = new AutoResetEvent(true);
    private static AutoResetEvent event_2 = new AutoResetEvent(false);

    static void Main()
    {
        Console.WriteLine("Press Enter to create three threads and start them.\r\n" +
                          "The threads wait on AutoResetEvent #1, which was created\r\n" +
                          "in the signaled state, so the first thread is released.\r\n" +
                          "This puts AutoResetEvent #1 into the unsignaled state.");
        Console.ReadLine();
            
        for (int i = 1; i < 4; i++)
        {
            Thread t = new Thread(ThreadProc);
            t.Name = "Thread_" + i;
            t.Start();
        }
        Thread.Sleep(250);

        for (int i = 0; i < 2; i++)
        {
            Console.WriteLine("Press Enter to release another thread.");
            Console.ReadLine();
            event_1.Set();
            Thread.Sleep(250);
        }

        Console.WriteLine("\r\nAll threads are now waiting on AutoResetEvent #2.");
        for (int i = 0; i < 3; i++)
        {
            Console.WriteLine("Press Enter to release a thread.");
            Console.ReadLine();
            event_2.Set();
            Thread.Sleep(250);
        }

        // Visual Studio: Uncomment the following line.
        //Console.Readline();
    }

    static void ThreadProc()
    {
        string name = Thread.CurrentThread.Name;

        Console.WriteLine("{0} waits on AutoResetEvent #1.", name);
        event_1.WaitOne();
        Console.WriteLine("{0} is released from AutoResetEvent #1.", name);

        Console.WriteLine("{0} waits on AutoResetEvent #2.", name);
        event_2.WaitOne();
        Console.WriteLine("{0} is released from AutoResetEvent #2.", name);

        Console.WriteLine("{0} ends.", name);
    }
}

/* This example produces output similar to the following:

Press Enter to create three threads and start them.
The threads wait on AutoResetEvent #1, which was created
in the signaled state, so the first thread is released.
This puts AutoResetEvent #1 into the unsignaled state.

Thread_1 waits on AutoResetEvent #1.
Thread_1 is released from AutoResetEvent #1.
Thread_1 waits on AutoResetEvent #2.
Thread_3 waits on AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #1.
Press Enter to release another thread.

Thread_3 is released from AutoResetEvent #1.
Thread_3 waits on AutoResetEvent #2.
Press Enter to release another thread.

Thread_2 is released from AutoResetEvent #1.
Thread_2 waits on AutoResetEvent #2.

All threads are now waiting on AutoResetEvent #2.
Press Enter to release a thread.

Thread_2 is released from AutoResetEvent #2.
Thread_2 ends.
Press Enter to release a thread.

Thread_1 is released from AutoResetEvent #2.
Thread_1 ends.
Press Enter to release a thread.

Thread_3 is released from AutoResetEvent #2.
Thread_3 ends.
 */

Imports System.Threading

' Visual Studio: Replace the default class in a Console project with 
'                the following class.
Class Example

    Private Shared event_1 As New AutoResetEvent(True)
    Private Shared event_2 As New AutoResetEvent(False)

    <MTAThread()> _
    Shared Sub Main()
    
        Console.WriteLine("Press Enter to create three threads and start them." & vbCrLf & _
                          "The threads wait on AutoResetEvent #1, which was created" & vbCrLf & _
                          "in the signaled state, so the first thread is released." & vbCrLf & _
                          "This puts AutoResetEvent #1 into the unsignaled state.")
        Console.ReadLine()
            
        For i As Integer = 1 To 3
            Dim t As New Thread(AddressOf ThreadProc)
            t.Name = "Thread_" & i
            t.Start()
        Next
        Thread.Sleep(250)

        For i As Integer = 1 To 2
            Console.WriteLine("Press Enter to release another thread.")
            Console.ReadLine()

            event_1.Set()
            Thread.Sleep(250)
        Next

        Console.WriteLine(vbCrLf & "All threads are now waiting on AutoResetEvent #2.")
        For i As Integer = 1 To 3
            Console.WriteLine("Press Enter to release a thread.")
            Console.ReadLine()

            event_2.Set()
            Thread.Sleep(250)
        Next

        ' Visual Studio: Uncomment the following line.
        'Console.Readline()
    End Sub

    Shared Sub ThreadProc()
    
        Dim name As String = Thread.CurrentThread.Name

        Console.WriteLine("{0} waits on AutoResetEvent #1.", name)
        event_1.WaitOne()
        Console.WriteLine("{0} is released from AutoResetEvent #1.", name)

        Console.WriteLine("{0} waits on AutoResetEvent #2.", name)
        event_2.WaitOne()
        Console.WriteLine("{0} is released from AutoResetEvent #2.", name)

        Console.WriteLine("{0} ends.", name)
    End Sub
End Class

' This example produces output similar to the following:
'
'Press Enter to create three threads and start them.
'The threads wait on AutoResetEvent #1, which was created
'in the signaled state, so the first thread is released.
'This puts AutoResetEvent #1 into the unsignaled state.
'
'Thread_1 waits on AutoResetEvent #1.
'Thread_1 is released from AutoResetEvent #1.
'Thread_1 waits on AutoResetEvent #2.
'Thread_3 waits on AutoResetEvent #1.
'Thread_2 waits on AutoResetEvent #1.
'Press Enter to release another thread.
'
'Thread_3 is released from AutoResetEvent #1.
'Thread_3 waits on AutoResetEvent #2.
'Press Enter to release another thread.
'
'Thread_2 is released from AutoResetEvent #1.
'Thread_2 waits on AutoResetEvent #2.
'
'All threads are now waiting on AutoResetEvent #2.
'Press Enter to release a thread.
'
'Thread_2 is released from AutoResetEvent #2.
'Thread_2 ends.
'Press Enter to release a thread.
'
'Thread_1 is released from AutoResetEvent #2.
'Thread_1 ends.
'Press Enter to release a thread.
'
'Thread_3 is released from AutoResetEvent #2.
'Thread_3 ends.

Comentários

Você usa AutoResetEvent, ManualResetEvente EventWaitHandle para interação de thread (ou sinalização de thread). Para obter mais informações, consulte de interação do Thread.

Um thread aguarda um sinal chamando AutoResetEvent.WaitOne. Se o AutoResetEvent estiver no estado não sinalizado, o thread será bloqueado até que AutoResetEvent.Set seja chamado. Chamar sinais SetAutoResetEvent para liberar um thread de espera. AutoResetEvent permanece sinalizado até que Reset seja chamado ou um único thread de espera seja liberado, momento em que ele retorna automaticamente para o estado não sinalizado.

Se nenhum thread estiver aguardando quando o AutoResetEvent entrar em um estado sinalizado, o estado permanecerá sinalizado até que um thread observe o sinal (chamando WaitOne). Esse thread não é bloqueado: o AutoResetEvent libera o thread imediatamente e retorna ao estado não sinalizado.

Importante

Não há garantia de que cada chamada para o método Set lançará um thread. Se duas chamadas estiverem muito próximas, para que a segunda chamada ocorra antes de um thread ser lançado, apenas um thread será liberado. É como se a segunda chamada não tivesse acontecido. Além disso, se Set for chamado quando não houver threads aguardando e o AutoResetEvent já estiver sinalizado, a chamada não terá efeito.

Você pode controlar o estado inicial de uma AutoResetEvent passando um valor booliano para o construtor: true se o estado inicial for sinalizado e false caso contrário.

AutoResetEvent também podem ser usados com os métodos staticWaitAll e WaitAny.

AutoResetEvent deriva da classe EventWaitHandle. Um AutoResetEvent é funcionalmente equivalente a um EventWaitHandle criado com EventResetMode.AutoReset.

Nota

Ao contrário da classe AutoResetEvent, a classe EventWaitHandle fornece acesso a eventos de sincronização do sistema nomeados.

Importante

Esse tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco de try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using (em C#) ou Using (no Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa idisposable" na página de interface IDisposable.

Construtores

AutoResetEvent(Boolean)

Inicializa uma nova instância da classe AutoResetEvent com um valor booliano indicando se o estado inicial deve ser sinalizado.

Campos

WaitTimeout

Indica que uma operação de WaitAny(WaitHandle[], Int32, Boolean) atingiu o tempo limite antes que qualquer um dos identificadores de espera fosse sinalizado. Esse campo é constante. (Herdado de WaitHandle)

Propriedades

Handle	Obsoleto. Obtém ou define o identificador do sistema operacional nativo. (Herdado de WaitHandle)
SafeWaitHandle	Obtém ou define o identificador do sistema operacional nativo. (Herdado de WaitHandle)

Métodos

Close()	Libera todos os recursos mantidos pelo WaitHandleatual. (Herdado de WaitHandle)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pela instância atual da classe WaitHandle. (Herdado de WaitHandle)
Dispose(Boolean)	Quando substituído em uma classe derivada, libera os recursos não gerenciados usados pelo WaitHandlee, opcionalmente, libera os recursos gerenciados. (Herdado de WaitHandle)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetAccessControl()	Obtém um objeto EventWaitHandleSecurity que representa a segurança do controle de acesso para o evento de sistema nomeado representado pelo objeto EventWaitHandle atual. (Herdado de EventWaitHandle)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Reset()	Define o estado do evento como não atribuído, fazendo com que os threads bloqueiem. (Herdado de EventWaitHandle)
Set()	Define o estado do evento como sinalizado, permitindo que um ou mais threads de espera prossigam. (Herdado de EventWaitHandle)
SetAccessControl(EventWaitHandleSecurity)	Define a segurança do controle de acesso para um evento do sistema nomeado. (Herdado de EventWaitHandle)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
WaitOne()	Bloqueia o thread atual até que o WaitHandle atual receba um sinal. (Herdado de WaitHandle)
WaitOne(Int32)	Bloqueia o thread atual até que o WaitHandle atual receba um sinal, usando um inteiro com sinal de 32 bits para especificar o intervalo de tempo em milissegundos. (Herdado de WaitHandle)
WaitOne(Int32, Boolean)	Bloqueia o thread atual até que o WaitHandle atual receba um sinal, usando um inteiro com sinal de 32 bits para especificar o intervalo de tempo e especificando se o domínio de sincronização deve sair antes da espera. (Herdado de WaitHandle)
WaitOne(TimeSpan)	Bloqueia o thread atual até que a instância atual receba um sinal, usando um TimeSpan para especificar o intervalo de tempo. (Herdado de WaitHandle)
WaitOne(TimeSpan, Boolean)	Bloqueia o thread atual até que a instância atual receba um sinal, usando um TimeSpan para especificar o intervalo de tempo e especificando se o domínio de sincronização deve ser encerrado antes da espera. (Herdado de WaitHandle)

Métodos de Extensão

GetAccessControl(EventWaitHandle)	Retorna os descritores de segurança para o handleespecificado.
SetAccessControl(EventWaitHandle, EventWaitHandleSecurity)	Define os descritores de segurança para o identificador de espera de evento especificado.
GetSafeWaitHandle(WaitHandle)	Obtém o identificador seguro de um identificador de espera do sistema operacional nativo.
SetSafeWaitHandle(WaitHandle, SafeWaitHandle)	Define um identificador seguro para um identificador de espera do sistema operacional nativo.

Acesso thread-safe

Essa classe é thread-safe.

Confira também

• WaitHandle
• de Threading Gerenciado
• visão geral dos primitivos de sincronização