EventWaitHandle Konstruktory

Definice

Obor názvů:

System.Threading

Sestavení:

System.Threading.dll

Inicializuje novou instanci EventWaitHandle třídy .

Přetížení

EventWaitHandle(Boolean, EventResetMode)	Inicializuje novou instanci EventWaitHandle třídy, určuje, zda je popisovač čekání původně signalizován a zda se resetuje automaticky nebo ručně.
EventWaitHandle(Boolean, EventResetMode, String)	Inicializuje novou instanci EventWaitHandle třídy, určuje, zda je popisovač čekání původně signalizován, pokud je vytvořen v důsledku tohoto volání, zda se automaticky nebo ručně resetuje a název události synchronizace systému.
EventWaitHandle(Boolean, EventResetMode, String, Boolean)	Inicializuje novou instanci EventWaitHandle třídy, určuje, zda je popisovač čekání původně signalizován, pokud je vytvořen v důsledku tohoto volání, zda se automaticky nebo ručně resetuje, název události synchronizace systému a logickou proměnnou, jejíž hodnota po volání označuje, zda byla vytvořena pojmenovaná systémová událost.

EventWaitHandle(Boolean, EventResetMode)

Zdroj:

EventWaitHandle.cs

Inicializuje novou instanci EventWaitHandle třídy, určuje, zda je popisovač čekání původně signalizován a zda se resetuje automaticky nebo ručně.

public:
 EventWaitHandle(bool initialState, System::Threading::EventResetMode mode);

public EventWaitHandle (bool initialState, System.Threading.EventResetMode mode);

new System.Threading.EventWaitHandle : bool * System.Threading.EventResetMode -> System.Threading.EventWaitHandle

Public Sub New (initialState As Boolean, mode As EventResetMode)

Parametry

initialState

Boolean

true nastavit počáteční stav signalizovat; false a nastavte ho na nepřiřazené.

mode

EventResetMode

Jedna z EventResetMode hodnot, která určuje, jestli se událost resetuje automaticky nebo ručně.

Výjimky

ArgumentException

Hodnota mode výčtu byla mimo zákonný rozsah.

Příklady

Následující příklad kódu používá SignalAndWait(WaitHandle, WaitHandle) přetížení metody, aby hlavní vlákno signalizovalo blokované vlákno a pak počkejte, dokud vlákno nedokončí úlohu.

Příklad spustí pět vláken a umožní jim blokovat na vytvořeném EventWaitHandle s příznakem EventResetMode.AutoReset a pak uvolní jedno vlákno pokaždé, když uživatel stiskne klávesu Enter . Příklad pak za frontu dalších pěti vláken a všechna je uvolní pomocí vytvořeného EventWaitHandle s příznakem EventResetMode.ManualReset .

using namespace System;
using namespace System::Threading;

public ref class Example
{
private:
   // The EventWaitHandle used to demonstrate the difference
   // between AutoReset and ManualReset synchronization events.
   //
   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.
   //
   static __int64 threadCount = 0;

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

public:
   [MTAThread]
   static void main()
   {
      // Create an AutoReset EventWaitHandle.
      //
      ewh = gcnew 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 = gcnew Thread(
            gcnew 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( threadCount ) < 5 )
      {
         Thread::Sleep( 500 );
      }

      // Release one thread each time the user presses ENTER,
      // until all threads have been released.
      //
      while ( Interlocked::Read( threadCount ) > 0 )
      {
         Console::WriteLine( L"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 = gcnew EventWaitHandle( false,EventResetMode::ManualReset );
      
      // Create and start five more numbered threads.
      //
      for ( int i = 0; i <= 4; i++ )
      {
         Thread^ t = gcnew Thread(
            gcnew ParameterizedThreadStart( ThreadProc ) );
         t->Start( i );
      }
      
      // Wait until all the threads have started and blocked.
      //
      while ( Interlocked::Read( threadCount ) < 5 )
      {
         Thread::Sleep( 500 );
      }

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

   }

   static void ThreadProc( Object^ data )
   {
      int index = static_cast<Int32>(data);

      Console::WriteLine( L"Thread {0} blocks.", data );
      // Increment the count of blocked threads.
      Interlocked::Increment( threadCount );
      
      // Wait on the EventWaitHandle.
      ewh->WaitOne();

      Console::WriteLine( L"Thread {0} exits.", data );
      // Decrement the count of blocked threads.
      Interlocked::Decrement( threadCount );
      
      // After signaling ewh, the main thread blocks on
      // clearCount until the signaled thread has
      // decremented the count. Signal it now.
      //
      clearCount->Set();
   }
};

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();
    }
}

Imports System.Threading

Public Class Example

    ' The EventWaitHandle used to demonstrate the difference
    ' between AutoReset and ManualReset synchronization events.
    '
    Private Shared ewh As EventWaitHandle

    ' 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 Shared threadCount As Long = 0

    ' An AutoReset event that allows the main thread to block
    ' until an exiting thread has decremented the count.
    '
    Private Shared clearCount As New EventWaitHandle(False, _
        EventResetMode.AutoReset)

    <MTAThread> _
    Public Shared Sub 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 i As Integer = 0 To 4
            Dim t As New Thread(AddressOf ThreadProc)
            t.Start(i)
        Next 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(threadCount) < 5
            Thread.Sleep(500)
        End While

        ' Release one thread each time the user presses ENTER,
        ' until all threads have been released.
        '
        While Interlocked.Read(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)
        End While
        Console.WriteLine()

        ' Create a ManualReset EventWaitHandle.
        '
        ewh = New EventWaitHandle(False, EventResetMode.ManualReset)

        ' Create and start five more numbered threads.
        '
        For i As Integer = 0 To 4
            Dim t As New Thread(AddressOf ThreadProc)
            t.Start(i)
        Next i

        ' Wait until all the threads have started and blocked.
        '
        While Interlocked.Read(threadCount) < 5
            Thread.Sleep(500)
        End While

        ' 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()
        
    End Sub

    Public Shared Sub ThreadProc(ByVal data As Object)
        Dim index As Integer = CInt(data)

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

        ' Wait on the EventWaitHandle.
        ewh.WaitOne()

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

        ' After signaling ewh, the main thread blocks on
        ' clearCount until the signaled thread has 
        ' decremented the count. Signal it now.
        '
        clearCount.Set()
    End Sub
End Class

Poznámky

Pokud počáteční stav události není přiřazený, vlákna čekající na událost se zablokují. Pokud je signalizovat počáteční stav a ManualReset příznak je zadán pro mode, vlákna, která čekají na událost, nebudou blokovat. Pokud je signalizovat počáteční stav a mode je AutoReset, první vlákno, které čeká na událost, bude okamžitě uvolněno, po kterém se událost resetuje a následná vlákna se zablokují.

Viz také

• Přehled primitiv synchronizace

EventWaitHandle(Boolean, EventResetMode, String)

Zdroj:

EventWaitHandle.cs

Inicializuje novou instanci EventWaitHandle třídy, určuje, zda je popisovač čekání původně signalizován, pokud je vytvořen v důsledku tohoto volání, zda se automaticky nebo ručně resetuje a název události synchronizace systému.

public:
 EventWaitHandle(bool initialState, System::Threading::EventResetMode mode, System::String ^ name);

public EventWaitHandle (bool initialState, System.Threading.EventResetMode mode, string? name);

new System.Threading.EventWaitHandle : bool * System.Threading.EventResetMode * string -> System.Threading.EventWaitHandle

Public Sub New (initialState As Boolean, mode As EventResetMode, name As String)

Parametry

initialState

Boolean

true nastavit počáteční stav signalizovat, pokud je v důsledku tohoto volání vytvořena pojmenovaná událost; false a nastavte ho na nepřiřazené.

mode

EventResetMode

Jedna z EventResetMode hodnot, která určuje, jestli se událost resetuje automaticky nebo ručně.

name

String

Název, pokud synchronizační objekt má být sdílen s jinými procesy; null nebo prázdný řetězec. V názvu se rozlišují velká a malá písmena. Znak zpětného lomítka (\) je vyhrazený a lze ho použít pouze k určení oboru názvů. Další informace o oborech názvů najdete v části s poznámkami. V závislosti na operačním systému můžou existovat další omezení pro název. Například v operačních systémech se systémem Unix musí být název po vyloučení oboru názvů platný název souboru.

Výjimky

IOException

Formát name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, jako je neznámá předpona nebo neplatné znaky. Všimněte si, že v názvu a běžných předponách Global a Local se rozlišují velká a malá písmena.

-nebo-

Došlo k jiné chybě. Vlastnost HResult může poskytnout další informace.

DirectoryNotFoundException

Pouze windows: name zadaný neznámý obor názvů. Další informace najdete v tématu Názvy objektů .

PathTooLongException

Je name moc dlouhý. Omezení délky mohou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaná událost existuje a má zabezpečení řízení přístupu, ale uživatel nemá FullControl.

WaitHandleCannotBeOpenedException

Objekt synchronizace se zadaným name objektem nelze vytvořit. Objekt synchronizace jiného typu může mít stejný název.

ArgumentException

Hodnota mode výčtu byla mimo zákonný rozsah.

-nebo-

Pouze rozhraní .NET Framework: name je delší než MAX_PATH (260 znaků).

Poznámky

Předpona nameGlobal\ může mít předponu nebo Local\ k určení oboru názvů. Při zadání Global oboru názvů může být synchronizační objekt sdílen s libovolnými procesy v systému. Local Pokud je zadán obor názvů, což je také výchozí, pokud není zadán žádný obor názvů, synchronizační objekt může být sdílen s procesy ve stejné relaci. V systému Windows je relace přihlášení a služby obvykle běží v jiné neinteraktivní relaci. V unixových operačních systémech má každé prostředí svoji vlastní relaci. Objekty místní synchronizace relace mohou být vhodné pro synchronizaci mezi procesy s nadřazeným a podřízeným vztahem, kde se všechny spouští ve stejné relaci. Další informace o názvech objektů synchronizace ve Windows najdete v tématu Názvy objektů.

name Pokud je zadaný objekt synchronizace požadovaného typu již v oboru názvů existuje, otevře se existující objekt synchronizace. Pokud v oboru názvů již existuje objekt synchronizace jiného typu, WaitHandleCannotBeOpenedException vyvolá se objekt . V opačném případě se vytvoří nový objekt synchronizace.

Pokud již existuje systémová událost s názvem zadaným name pro parametr, initialState parametr se ignoruje.

Upozornění

Ve výchozím nastavení není pojmenovaná událost omezena na uživatele, který ji vytvořil. Jiní uživatelé můžou událost otevřít a používat, včetně narušení události jejím nevhodným nastavením nebo resetováním. Pokud chcete omezit přístup na konkrétní uživatele, můžete při vytváření pojmenované události použít přetížení konstruktoru EventWaitHandleSecurity nebo EventWaitHandleAcl předat objekt. Vyhněte se používání pojmenovaných událostí bez omezení přístupu v systémech, které můžou mít nedůvěryhodné uživatele se spuštěným kódem.

Důležité

Při použití tohoto konstruktoru pro pojmenované systémové události zadejte false pro initialState. Tento konstruktor neposkytuje žádný způsob, jak zjistit, zda byla vytvořena pojmenovaná systémová událost, takže nelze provádět žádné předpoklady o stavu pojmenované události. Chcete-li zjistit, zda byla vytvořena pojmenovaná událost, použijte EventWaitHandle(Boolean, EventResetMode, String, Boolean) konstruktor nebo EventWaitHandle(Boolean, EventResetMode, String, Boolean, EventWaitHandleSecurity) konstruktor.

Pokud počáteční stav události není přiřazený, vlákna čekající na událost se zablokují. Pokud je signalizovat počáteční stav a ManualReset příznak je zadán pro mode, vlákna, která čekají na událost, nebudou blokovat. Pokud je signalizovat počáteční stav a mode je AutoReset, první vlákno, které čeká na událost, bude okamžitě uvolněno, po kterém se událost resetuje a následná vlákna se zablokují.

Viz také

• Přehled primitiv synchronizace

EventWaitHandle(Boolean, EventResetMode, String, Boolean)

Zdroj:

EventWaitHandle.cs

Inicializuje novou instanci EventWaitHandle třídy, určuje, zda je obslužná rutina čekání zpočátku signalizována, pokud je vytvořena v důsledku tohoto volání, zda se automaticky nebo ručně resetuje, název události synchronizace systému a logická proměnná, jejíž hodnota po volání označuje, zda byla vytvořena pojmenovaná systémová událost.

public:
 EventWaitHandle(bool initialState, System::Threading::EventResetMode mode, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew);

public EventWaitHandle (bool initialState, System.Threading.EventResetMode mode, string? name, out bool createdNew);

new System.Threading.EventWaitHandle : bool * System.Threading.EventResetMode * string * bool -> System.Threading.EventWaitHandle

Public Sub New (initialState As Boolean, mode As EventResetMode, name As String, ByRef createdNew As Boolean)

Parametry

initialState

Boolean

true nastavit počáteční stav signalizovat, pokud je v důsledku tohoto volání vytvořena pojmenovaná událost; false a nastavte ho na nepřiřazené.

mode

EventResetMode

Jedna z EventResetMode hodnot, která určuje, jestli se událost resetuje automaticky nebo ručně.

name

String

Název, pokud synchronizační objekt má být sdílen s jinými procesy; null nebo prázdný řetězec. V názvu se rozlišují velká a malá písmena. Znak zpětného lomítka (\) je vyhrazený a lze ho použít pouze k určení oboru názvů. Další informace o oborech názvů najdete v části s poznámkami. V závislosti na operačním systému můžou existovat další omezení pro název. Například v operačních systémech se systémem Unix musí být název po vyloučení oboru názvů platný název souboru.

createdNew

Boolean

Když tato metoda vrátí, obsahuje true , jestli byla vytvořena místní událost (tj. pokud name je null nebo prázdný řetězec) nebo jestli byla vytvořena zadaná pojmenovaná systémová událost; false pokud zadaná pojmenovaná systémová událost již existovala. Tento parametr se předává neinicializovaný.

Výjimky

IOException

Formát name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, jako je neznámá předpona nebo neplatné znaky. Všimněte si, že v názvu a běžných předponách Global a Local se rozlišují velká a malá písmena.

-nebo-

Došlo k jiné chybě. Vlastnost HResult může poskytnout další informace.

DirectoryNotFoundException

Pouze windows: name zadaný neznámý obor názvů. Další informace najdete v tématu Názvy objektů .

PathTooLongException

Je name moc dlouhý. Omezení délky mohou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaná událost existuje a má zabezpečení řízení přístupu, ale uživatel nemá FullControl.

WaitHandleCannotBeOpenedException

Objekt synchronizace se zadaným name objektem nelze vytvořit. Objekt synchronizace jiného typu může mít stejný název.

ArgumentException

Hodnota mode výčtu byla mimo zákonný rozsah.

-nebo-

Pouze rozhraní .NET Framework: name je delší než MAX_PATH (260 znaků).

Poznámky

Předpona nameGlobal\ může mít předponu nebo Local\ k určení oboru názvů. Global Pokud je obor názvů zadaný, synchronizační objekt může být sdílen se všemi procesy v systému. Local Pokud je zadán obor názvů, což je také výchozí, pokud není zadán žádný obor názvů, synchronizační objekt může být sdílen s procesy ve stejné relaci. Ve Windows je relace přihlášení a služby obvykle běží v jiné neinteraktivní relaci. V unixových operačních systémech má každé prostředí svoji vlastní relaci. Objekty místní synchronizace relace mohou být vhodné pro synchronizaci mezi procesy se vztahem nadřazenosti a podřízenosti, kde se všechny spouští ve stejné relaci. Další informace o názvech synchronizačních objektů ve Windows najdete v tématu Názvy objektů.

name Pokud je zadán a objekt synchronizace požadovaného typu již existuje v oboru názvů, existující synchronizační objekt je otevřen. Pokud synchronizační objekt jiného typu již v oboru názvů existuje, WaitHandleCannotBeOpenedException vyvolá se objekt . V opačném případě se vytvoří nový synchronizační objekt.

Pokud již existuje systémová událost s názvem zadaným name pro parametr, initialState parametr se ignoruje. Po volání tohoto konstruktoru použijte hodnotu v proměnné zadané pro ref parametr (ByRef parametr v jazyce Visual Basic)createdNew k určení, zda pojmenovaná systémová událost již existovala nebo byla vytvořena.

Pokud je počáteční stav události nepřiřazený, vlákna, která na událost čekají, budou blokována. Pokud je počáteční stav signalován a ManualReset příznak je zadán pro mode, vlákna, která čekají na událost, nebudou blokována. Pokud je signalizoval počáteční stav a mode je AutoReset, první vlákno, které čeká na událost, bude okamžitě uvolněno, po kterém se událost resetuje a další vlákna se zablokují.

Upozornění

Ve výchozím nastavení není pojmenovaná událost omezena na uživatele, který ji vytvořil. Ostatní uživatelé mohou mít možnost událost otevřít a používat, včetně toho, že událost narušují tím, že ji nastavují nebo resetují nevhodně. Pokud chcete omezit přístup na konkrétní uživatele, můžete při vytváření pojmenované události použít přetížení konstruktoru nebo EventWaitHandleAcl předat .EventWaitHandleSecurity Vyhněte se používání pojmenovaných událostí bez omezení přístupu v systémech, které můžou mít nedůvěryhodné uživatele spouštěné kódem.

Viz také

• Přehled primitiv synchronizace