EventWaitHandle Klasa

Definicja

Reprezentuje zdarzenie synchronizacji wątków.

public class EventWaitHandle : System.Threading.WaitHandle
[System.Runtime.InteropServices.ComVisible(true)]
public class EventWaitHandle : System.Threading.WaitHandle
Dziedziczenie
EventWaitHandle
Dziedziczenie
Pochodne
Atrybuty

Przykłady

Poniższy przykład kodu używa SignalAndWait(WaitHandle, WaitHandle) przeciążenia metody, aby umożliwić głównemu wątkowi sygnalizowanie zablokowanego wątku, a następnie poczekaj, aż wątek zakończy zadanie.

W przykładzie uruchamia się pięć wątków i pozwala im blokować EventWaitHandle tworzenie za pomocą EventResetMode.AutoReset flagi, a następnie zwalnia jeden wątek za każdym razem, gdy użytkownik naciska klawisz Enter . W tym przykładzie kolejkuje kolejne pięć wątków i zwalnia je wszystkie przy użyciu utworzonej EventWaitHandle flagi EventResetMode.ManualReset .

using System;
using System.Threading;

public class Example
{
    // The EventWaitHandle used to demonstrate the difference
    // between AutoReset and ManualReset synchronization events.
    //
    private static EventWaitHandle ewh;

    // A counter to make sure all threads are started and
    // blocked before any are released. A Long is used to show
    // the use of the 64-bit Interlocked methods.
    //
    private static long threadCount = 0;

    // An AutoReset event that allows the main thread to block
    // until an exiting thread has decremented the count.
    //
    private static EventWaitHandle clearCount = 
        new EventWaitHandle(false, EventResetMode.AutoReset);

    [MTAThread]
    public static void Main()
    {
        // Create an AutoReset EventWaitHandle.
        //
        ewh = new EventWaitHandle(false, EventResetMode.AutoReset);

        // Create and start five numbered threads. Use the
        // ParameterizedThreadStart delegate, so the thread
        // number can be passed as an argument to the Start 
        // method.
        for (int i = 0; i <= 4; i++)
        {
            Thread t = new Thread(
                new ParameterizedThreadStart(ThreadProc)
            );
            t.Start(i);
        }

        // Wait until all the threads have started and blocked.
        // When multiple threads use a 64-bit value on a 32-bit
        // system, you must access the value through the
        // Interlocked class to guarantee thread safety.
        //
        while (Interlocked.Read(ref threadCount) < 5)
        {
            Thread.Sleep(500);
        }

        // Release one thread each time the user presses ENTER,
        // until all threads have been released.
        //
        while (Interlocked.Read(ref threadCount) > 0)
        {
            Console.WriteLine("Press ENTER to release a waiting thread.");
            Console.ReadLine();

            // SignalAndWait signals the EventWaitHandle, which
            // releases exactly one thread before resetting, 
            // because it was created with AutoReset mode. 
            // SignalAndWait then blocks on clearCount, to 
            // allow the signaled thread to decrement the count
            // before looping again.
            //
            WaitHandle.SignalAndWait(ewh, clearCount);
        }
        Console.WriteLine();

        // Create a ManualReset EventWaitHandle.
        //
        ewh = new EventWaitHandle(false, EventResetMode.ManualReset);

        // Create and start five more numbered threads.
        //
        for(int i=0; i<=4; i++)
        {
            Thread t = new Thread(
                new ParameterizedThreadStart(ThreadProc)
            );
            t.Start(i);
        }

        // Wait until all the threads have started and blocked.
        //
        while (Interlocked.Read(ref threadCount) < 5)
        {
            Thread.Sleep(500);
        }

        // Because the EventWaitHandle was created with
        // ManualReset mode, signaling it releases all the
        // waiting threads.
        //
        Console.WriteLine("Press ENTER to release the waiting threads.");
        Console.ReadLine();
        ewh.Set();
    }

    public static void ThreadProc(object data)
    {
        int index = (int) data;

        Console.WriteLine("Thread {0} blocks.", data);
        // Increment the count of blocked threads.
        Interlocked.Increment(ref threadCount);

        // Wait on the EventWaitHandle.
        ewh.WaitOne();

        Console.WriteLine("Thread {0} exits.", data);
        // Decrement the count of blocked threads.
        Interlocked.Decrement(ref threadCount);

        // After signaling ewh, the main thread blocks on
        // clearCount until the signaled thread has 
        // decremented the count. Signal it now.
        //
        clearCount.Set();
    }
}

Uwagi

Klasa EventWaitHandle umożliwia wątkom komunikowanie się ze sobą przez sygnalizowanie. Zazwyczaj co najmniej jeden wątek blokuje się do EventWaitHandle momentu wywołania metody przez odblokowany wątek Set , zwalniając co najmniej jeden zablokowany wątek. Wątek może sygnalizować, a następnie zablokować go, wywołując metodę EventWaitHandlestatic (Shared w Visual Basic). WaitHandle.SignalAndWait

Uwaga

Klasa EventWaitHandle zapewnia dostęp do nazwanych zdarzeń synchronizacji systemu.

Zachowanie sygnału EventWaitHandle , które zostało zasygnalizowane, zależy od jego trybu resetowania. Utworzony EventWaitHandle z flagą jest resetowany automatycznie po wysłaniu EventResetMode.AutoReset sygnału po zwolnieniu pojedynczego wątku oczekiwania. Utworzona EventWaitHandle z flagą EventResetMode.ManualReset pozostaje zasygnalizowana do momentu wywołania metody Reset .

Zdarzenia automatycznego resetowania zapewniają wyłączny dostęp do zasobu. Jeśli zdarzenie automatycznego resetowania jest sygnalizowane, gdy nie czekają wątki, pozostaje zasygnalizowany, aż wątek podejmie próbę oczekiwania. Zdarzenie zwalnia wątek i natychmiast resetuje, blokując kolejne wątki.

Zdarzenia resetowania ręcznego są takie jak bramy. Gdy zdarzenie nie jest sygnalizowane, wątki oczekujące na nie będą blokowane. Gdy zdarzenie zostanie zasygnalizowane, wszystkie wątki oczekujące zostaną zwolnione, a zdarzenie pozostaje zasygnalizowane (czyli kolejne oczekiwania nie blokują) do momentu wywołania metody Reset . Zdarzenia resetowania ręcznego są przydatne, gdy jeden wątek musi ukończyć działanie, zanim inne wątki będą mogły kontynuować.

EventWaitHandle obiekty mogą być używane z metodami static(Shared w Visual Basic) WaitHandle.WaitAll i WaitHandle.WaitAny .

Aby uzyskać więcej informacji, zobacz sekcję Interakcja z wątkiem lub sygnalizacyjną w artykule Omówienie elementów pierwotnych synchronizacji .

Przestroga

Domyślnie nazwane zdarzenie nie jest ograniczone do użytkownika, który go utworzył. Inni użytkownicy mogą być w stanie otworzyć zdarzenie i korzystać z niego, w tym zakłócać działanie zdarzenia przez ustawienie lub zresetować je niewłaściwie. Aby ograniczyć dostęp do określonych użytkowników, możesz użyć przeciążenia konstruktora lub EventWaitHandleAcl przekazać go EventWaitHandleSecurity podczas tworzenia nazwanego zdarzenia. Unikaj używania nazwanych zdarzeń bez ograniczeń dostępu w systemach, które mogą mieć niezaufanych użytkowników z uruchomionym kodem.

Konstruktory

EventWaitHandle(Boolean, EventResetMode)

Inicjuje EventWaitHandle nowe wystąpienie klasy, określając, czy dojście oczekiwania jest początkowo sygnalizowane, i czy resetuje się automatycznie, czy ręcznie.

EventWaitHandle(Boolean, EventResetMode, String)

Inicjuje nowe wystąpienie EventWaitHandle klasy, określając, czy uchwyt oczekiwania jest początkowo sygnalizowany w wyniku tego wywołania, czy jest resetowany automatycznie, czy ręcznie, oraz nazwę zdarzenia synchronizacji systemu.

EventWaitHandle(Boolean, EventResetMode, String, Boolean)

Inicjuje nowe wystąpienie EventWaitHandle klasy, określając, czy uchwyt oczekiwania jest początkowo sygnalizowany w wyniku tego wywołania, czy jest resetowany automatycznie, czy ręcznie, nazwa zdarzenia synchronizacji systemu i zmienna logiczna, której wartość po wywołaniu wskazuje, czy nazwane zdarzenie systemowe zostało utworzone.

EventWaitHandle(Boolean, EventResetMode, String, Boolean, EventWaitHandleSecurity)

Inicjuje nowe wystąpienie EventWaitHandle klasy, określając, czy uchwyt oczekiwania jest początkowo sygnalizowany w wyniku tego wywołania, czy jest resetowany automatycznie, czy ręcznie, nazwa zdarzenia synchronizacji systemu, zmienna logiczna, której wartość po wywołaniu wskazuje, czy nazwane zdarzenie systemowe zostało utworzone, oraz zabezpieczenia kontroli dostępu, które mają zostać zastosowane do nazwanego zdarzenia, jeśli zostanie utworzone.

Pola

WaitTimeout

Wskazuje, że WaitAny(WaitHandle[], Int32, Boolean) upłynął limit czasu operacji, zanim którykolwiek z uchwytów oczekiwania został zasygnalizowany. To pole jest stałe.

(Odziedziczone po WaitHandle)

Właściwości

Handle
Przestarzałe.
Przestarzałe.

Pobiera lub ustawia natywny uchwyt systemu operacyjnego.

(Odziedziczone po WaitHandle)
SafeWaitHandle

Pobiera lub ustawia natywny uchwyt systemu operacyjnego.

(Odziedziczone po WaitHandle)

Metody

Close()

Zwalnia wszystkie zasoby przechowywane przez bieżący WaitHandleelement .

(Odziedziczone po WaitHandle)
CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy WaitHandle.

(Odziedziczone po WaitHandle)
Dispose(Boolean)

Po zastąpieniu w klasie pochodnej zwalnia niezarządzane zasoby używane przez WaitHandleprogram i opcjonalnie zwalnia zarządzane zasoby.

(Odziedziczone po WaitHandle)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetAccessControl()

EventWaitHandleSecurity Pobiera obiekt reprezentujący zabezpieczenia kontroli dostępu dla nazwanego zdarzenia systemowego reprezentowanego przez bieżący EventWaitHandle obiekt.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Przestarzałe.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
OpenExisting(String)

Otwiera określone nazwane zdarzenie synchronizacji, jeśli już istnieje.

OpenExisting(String, EventWaitHandleRights)

Otwiera określone nazwane zdarzenie synchronizacji, jeśli już istnieje, z żądanym dostępem do zabezpieczeń.

Reset()

Ustawia stan zdarzenia na niepodpisany, powodując zablokowanie wątków.

Set()

Ustawia stan zdarzenia na sygnał, umożliwiając kontynuowanie co najmniej jednego wątku oczekiwania.

SetAccessControl(EventWaitHandleSecurity)

Ustawia zabezpieczenia kontroli dostępu dla nazwanego zdarzenia systemowego.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
TryOpenExisting(String, EventWaitHandle)

Otwiera określone nazwane zdarzenie synchronizacji, jeśli już istnieje, i zwraca wartość wskazującą, czy operacja zakończyła się pomyślnie.

TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)

Otwiera określone nazwane zdarzenie synchronizacji, jeśli już istnieje, z żądanym dostępem zabezpieczeń i zwraca wartość wskazującą, czy operacja zakończyła się pomyślnie.

WaitOne()

Blokuje bieżący wątek, dopóki bieżący WaitHandle nie otrzyma sygnału.

(Odziedziczone po WaitHandle)
WaitOne(Int32)

Blokuje bieżący wątek do WaitHandle momentu odebrania sygnału przy użyciu 32-bitowej liczby całkowitej podpisanej w celu określenia interwału czasu w milisekundach.

(Odziedziczone po WaitHandle)
WaitOne(Int32, Boolean)

Blokuje bieżący wątek do WaitHandle momentu odebrania sygnału przy użyciu 32-bitowej liczby całkowitej podpisanej w celu określenia interwału czasu i określenia, czy należy zamknąć domenę synchronizacji przed oczekiwaniem.

(Odziedziczone po WaitHandle)
WaitOne(TimeSpan)

Blokuje bieżący wątek, dopóki bieżące wystąpienie nie otrzyma sygnału przy użyciu elementu , TimeSpan aby określić interwał czasu.

(Odziedziczone po WaitHandle)
WaitOne(TimeSpan, Boolean)

Blokuje bieżący wątek, dopóki bieżące wystąpienie nie otrzyma sygnału, przy użyciu elementu , TimeSpan aby określić interwał czasu i określić, czy należy zamknąć domenę synchronizacji przed oczekiwaniem.

(Odziedziczone po WaitHandle)

Jawne implementacje interfejsu

IDisposable.Dispose()

Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu.

Zwalnia wszelkie zasoby używane przez element WaitHandle.

(Odziedziczone po WaitHandle)

Metody rozszerzania

GetAccessControl(EventWaitHandle)

Zwraca deskryptory zabezpieczeń dla określonego handleelementu .

SetAccessControl(EventWaitHandle, EventWaitHandleSecurity)

Ustawia deskryptory zabezpieczeń dla określonego uchwytu oczekiwania na zdarzenia.

GetSafeWaitHandle(WaitHandle)

Pobiera bezpieczny uchwyt dla natywnego uchwytu oczekiwania systemu operacyjnego.

SetSafeWaitHandle(WaitHandle, SafeWaitHandle)

Ustawia bezpieczny uchwyt dla natywnego uchwytu oczekiwania systemu operacyjnego.

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkowo.

Zobacz też