AutoResetEvent Класс

Определение

Пространство имен:

System.Threading

Сборки:

netstandard.dll, System.Threading.dll

Исходный код:

AutoResetEvent.cs

Представляет событие синхронизации потоков, которое при сигнале освобождает один поток ожидания и автоматически сбрасывает его. Этот класс не может быть унаследован.

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

Наследование

Object

MarshalByRefObject

WaitHandle

EventWaitHandle

AutoResetEvent

Примеры

В следующем примере показано, как одновременно AutoResetEvent выпускать один поток, вызывая Set метод (в базовом классе) каждый раз, когда пользователь нажимает клавишу ВВОД . В примере запускаются три потока, ожидающие AutoResetEvent создания в сигнальном состоянии. Первый поток освобождается немедленно, так как AutoResetEvent он уже находится в сигнальном состоянии. При этом сбрасывается AutoResetEvent состояние без сигнала, чтобы последующие потоки блокировались. Заблокированные потоки не выпускаются, пока пользователь не освобождает их по одному за раз, нажав клавишу ВВОД .

После освобождения потоков от первого AutoResetEventони ожидают другого AutoResetEvent , который был создан в состоянии, отличном от сигнала. Все три блока потоков, поэтому Set метод должен вызываться три раза, чтобы освободить их все.

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.

Комментарии

Используется AutoResetEvent, ManualResetEventа также EventWaitHandle для взаимодействия с потоком (или сигналов потока). Дополнительные сведения см. в разделе "Взаимодействие с потоком".

Поток ожидает сигнала, вызвав AutoResetEvent.WaitOne. Если он AutoResetEvent находится в состоянии без сигнала, поток блокируется до вызова AutoResetEvent.Set . Вызов Set сигналов AutoResetEvent для освобождения потока ожидания. AutoResetEvent остается сигналом до тех пор, пока Reset не будет вызван или выпущен один поток ожидания, в то время как он автоматически возвращается в состояние без сигнала.

Если потоки не ожидают, когда AutoResetEvent переход в сигнальное состояние, состояние остается сигналом до тех пор, пока поток не увидит сигнал (вызывая WaitOne). Этот поток не блокируется: AutoResetEvent немедленно освобождает поток и возвращается в состояние без сигнала.

Важный

Нет никакой Set гарантии, что каждый вызов метода выпустит поток. Если два вызова слишком близко друг к другу, поэтому второй вызов возникает перед выпуском потока, освобождается только один поток. Это как будто второй звонок не произошел. Кроме того, если вызов вызывается, когда Set нет потоков ожидания и AutoResetEvent уже сигнализирует, вызов не имеет эффекта.

Вы можете управлять начальным состоянием объекта AutoResetEvent , передав логическое значение конструктору: true если начальное состояние сигнализируется и false в противном случае.

AutoResetEventтакже можно использовать с методами и WaitAny методамиstaticWaitAll.

AutoResetEvent производный от EventWaitHandle класса. Функционально AutoResetEvent эквивалентен созданному EventResetMode.AutoResetобъектуEventWaitHandle.

Заметка

AutoResetEvent В отличие от класса, EventWaitHandle класс предоставляет доступ к именованным событиям синхронизации системы.

Важный

Этот тип реализует IDisposable интерфейс. Завершив использование типа, его следует удалить напрямую или косвенно. Чтобы удалить тип напрямую, вызовите его Dispose метод в блоке try/catch . Чтобы удалить его косвенно, используйте конструкцию языка, например using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" на IDisposable странице интерфейса.

Конструкторы

Имя	Описание
AutoResetEvent(Boolean)	Инициализирует новый экземпляр AutoResetEvent класса с логическим значением, указывающим, следует ли задать начальное состояние для сигнала.

Поля

Имя	Описание
WaitTimeout	Указывает, что операция истекла до того, WaitAny(WaitHandle[], Int32, Boolean) как любой из дескрипторов ожидания был сигналирован. Это поле является константой. (Унаследовано от WaitHandle)

Свойства

Имя	Описание
Handle	Устаревшие.. Возвращает или задает дескриптор собственной операционной системы. (Унаследовано от WaitHandle)
SafeWaitHandle	Возвращает или задает дескриптор собственной операционной системы. (Унаследовано от WaitHandle)

Методы

Имя	Описание
Close()	Освобождает все ресурсы, удерживаемые текущим WaitHandle. (Унаследовано от WaitHandle)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса WaitHandle. (Унаследовано от WaitHandle)
Dispose(Boolean)	При переопределении в производном классе освобождает неуправляемые ресурсы, используемые и WaitHandleпри необходимости освобождает управляемые ресурсы. (Унаследовано от WaitHandle)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject)
Reset()	Задает состояние события незначаемой, что приводит к блокировке потоков. (Унаследовано от EventWaitHandle)
Set()	Задает состояние сигнала события, что позволяет продолжить один или несколько потоков ожидания. (Унаследовано от EventWaitHandle)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
WaitOne()	Блокирует текущий поток, пока текущий WaitHandle не получит сигнал. (Унаследовано от WaitHandle)
WaitOne(Int32, Boolean)	Блокирует текущий поток, пока текущий WaitHandle не получит сигнал, используя 32-разрядное целое число со знаком, чтобы указать интервал времени и указать, следует ли выйти из домена синхронизации перед ожиданием. (Унаследовано от WaitHandle)
WaitOne(Int32)	Блокирует текущий поток, пока текущий WaitHandle не получит сигнал, используя 32-разрядное целое число со знаком, чтобы указать интервал времени в миллисекундах. (Унаследовано от WaitHandle)
WaitOne(TimeSpan, Boolean)	Блокирует текущий поток, пока текущий экземпляр не получит сигнал, используя TimeSpan интервал времени и указав, следует ли выйти из домена синхронизации перед ожиданием. (Унаследовано от WaitHandle)
WaitOne(TimeSpan)	Блокирует текущий поток, пока текущий экземпляр не получит сигнал, используя TimeSpan интервал времени. (Унаследовано от WaitHandle)

Методы расширения

Имя	Описание
GetAccessControl(EventWaitHandle)	Возвращает дескрипторы безопасности для указанного handle.
GetSafeWaitHandle(WaitHandle)	Возвращает безопасный дескриптор для собственного дескриптора ожидания операционной системы.
SetAccessControl(EventWaitHandle, EventWaitHandleSecurity)	Задает дескрипторы безопасности для указанного дескриптора ожидания события.
SetSafeWaitHandle(WaitHandle, SafeWaitHandle)	Задает безопасный дескриптор для собственного дескриптора ожидания операционной системы.

Потокобезопасность

Этот класс является потокобезопасной.

См. также раздел

• WaitHandle
• Управляемая многопоточность
• Обзор примитивов синхронизации