EventWaitHandle Konstruktory

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.dll

Inicjuje nowe wystąpienie klasy EventWaitHandle.

Przeciążenia

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)

Źródło:

EventWaitHandle.cs

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.

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 aby ustawić stan początkowy na sygnalizowany; false aby ustawić go na niepodpisane.

mode

EventResetMode

EventResetMode Jedna z wartości określających, czy zdarzenie jest resetowane automatycznie, czy ręcznie.

Wyjątki

ArgumentException

Wartość mode wyliczenia była poza zakresem prawnym.

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 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

Uwagi

Jeśli początkowy stan zdarzenia jest niepodpisany, wątki oczekujące na zdarzenie będą blokowane. Jeśli stan początkowy jest sygnalizowany, a flaga ManualReset jest określona dla modeelementu , wątki oczekujące na zdarzenie nie będą blokowane. Jeśli stan początkowy zostanie zasygnalizowany i mode jest AutoResetto , pierwszy wątek, który czeka na zdarzenie zostanie zwolniony natychmiast, po którym zdarzenie zostanie zresetowane, a kolejne wątki będą blokowane.

Zobacz też

• Przegląd elementów podstawowych synchronizacji

EventWaitHandle(Boolean, EventResetMode, String)

Źródło:

EventWaitHandle.cs

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.

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 aby ustawić stan początkowy na sygnał, jeśli nazwane zdarzenie jest tworzone w wyniku tego wywołania; false aby ustawić go na niepodpisane.

mode

EventResetMode

EventResetMode Jedna z wartości określających, czy zdarzenie jest resetowane automatycznie, czy ręcznie.

name

String

Nazwa, jeśli obiekt synchronizacji ma być współużytkowany z innymi procesami; null w przeciwnym razie lub pusty ciąg. W nazwie jest rozróżniana wielkość liter. Znak ukośnika odwrotnego (\) jest zarezerwowany i może służyć tylko do określania przestrzeni nazw. Aby uzyskać więcej informacji na temat przestrzeni nazw, zobacz sekcję uwagi. W zależności od systemu operacyjnego mogą istnieć dalsze ograniczenia dotyczące nazwy. Na przykład w systemach operacyjnych opartych na systemie Unix nazwa po wykluczeniu przestrzeni nazw musi być prawidłową nazwą pliku.

Wyjątki

IOException

Nazwa name jest niepoprawna. Może to być z różnych powodów, w tym niektóre ograniczenia, które mogą zostać wprowadzone przez system operacyjny, takie jak nieznany prefiks lub nieprawidłowe znaki. Należy pamiętać, że nazwy i typowe prefiksy "Global\" i "Local\" są uwzględniane wielkość liter.

-lub-

Wystąpił inny błąd. Właściwość HResult może dostarczyć więcej informacji.

DirectoryNotFoundException

Tylko system Windows: name określono nieznaną przestrzeń nazw. Aby uzyskać więcej informacji, zobacz Nazwy obiektów .

PathTooLongException

Jest name za długi. Ograniczenia długości mogą zależeć od systemu operacyjnego lub konfiguracji.

UnauthorizedAccessException

Nazwane zdarzenie istnieje i ma zabezpieczenia kontroli dostępu, ale użytkownik nie ma FullControl.

WaitHandleCannotBeOpenedException

Nie można utworzyć obiektu synchronizacji z podanym name . Obiekt synchronizacji innego typu może mieć taką samą nazwę.

ArgumentException

Wartość mode wyliczenia była poza zakresem prawnym.

-lub-

Tylko program .NET Framework: name jest dłuższy niż MAX_PATH (260 znaków).

Uwagi

Element name może być poprzedzony prefiksem Global\ lub Local\ w celu określenia przestrzeni nazw. Po określeniu Global przestrzeni nazw obiekt synchronizacji może być współużytkowany z dowolnymi procesami w systemie. Po określeniu Local przestrzeni nazw, która jest również domyślna, gdy nie określono przestrzeni nazw, obiekt synchronizacji może być współużytkowany z procesami w tej samej sesji. W systemie Windows sesja jest sesją logowania, a usługi są zwykle uruchamiane w innej sesji nieinterakcyjnej. W systemach operacyjnych podobnych do systemu Unix każda powłoka ma własną sesję. Obiekty synchronizacji lokalnej sesji mogą być odpowiednie do synchronizowania procesów z relacją nadrzędną/podrzędną, w której wszystkie są uruchamiane w tej samej sesji. Aby uzyskać więcej informacji na temat nazw obiektów synchronizacji w systemie Windows, zobacz Nazwy obiektów.

name Jeśli element jest podany, a obiekt synchronizacji żądanego typu już istnieje w przestrzeni nazw, istniejący obiekt synchronizacji jest otwarty. Jeśli obiekt synchronizacji innego typu już istnieje w przestrzeni nazw, WaitHandleCannotBeOpenedException jest zgłaszany. W przeciwnym razie zostanie utworzony nowy obiekt synchronizacji.

Jeśli zdarzenie systemowe o nazwie określonej dla parametru name już istnieje, initialState parametr jest ignorowany.

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.

Ważne

W przypadku używania tego konstruktora dla nazwanych zdarzeń systemowych określ false wartość initialState. Ten konstruktor nie umożliwia określenia, czy zostało utworzone nazwane zdarzenie systemowe, więc nie można założyć żadnych założeń dotyczących stanu nazwanego zdarzenia. Aby określić, czy nazwane zdarzenie zostało utworzone, użyj konstruktora EventWaitHandle(Boolean, EventResetMode, String, Boolean) lub konstruktora EventWaitHandle(Boolean, EventResetMode, String, Boolean, EventWaitHandleSecurity) .

Jeśli początkowy stan zdarzenia jest niepodpisany, wątki oczekujące na zdarzenie będą blokowane. Jeśli stan początkowy jest sygnalizowany, a flaga ManualReset jest określona dla modeelementu , wątki oczekujące na zdarzenie nie będą blokowane. Jeśli stan początkowy zostanie zasygnalizowany i mode jest AutoResetto , pierwszy wątek, który czeka na zdarzenie zostanie zwolniony natychmiast, po którym zdarzenie zostanie zresetowane, a kolejne wątki będą blokowane.

Zobacz też

• Przegląd elementów podstawowych synchronizacji

EventWaitHandle(Boolean, EventResetMode, String, Boolean)

Źródło:

EventWaitHandle.cs

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.

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 aby ustawić stan początkowy na sygnał, jeśli nazwane zdarzenie jest tworzone w wyniku tego wywołania; false aby ustawić go na niepodpisane.

mode

EventResetMode

EventResetMode Jedna z wartości określających, czy zdarzenie jest resetowane automatycznie, czy ręcznie.

name

String

Nazwa, jeśli obiekt synchronizacji ma być współużytkowany z innymi procesami; null w przeciwnym razie lub pusty ciąg. W nazwie jest rozróżniana wielkość liter. Znak ukośnika odwrotnego (\) jest zarezerwowany i może służyć tylko do określania przestrzeni nazw. Aby uzyskać więcej informacji na temat przestrzeni nazw, zobacz sekcję uwagi. W zależności od systemu operacyjnego mogą istnieć dalsze ograniczenia dotyczące nazwy. Na przykład w systemach operacyjnych opartych na systemie Unix nazwa po wykluczeniu przestrzeni nazw musi być prawidłową nazwą pliku.

createdNew

Boolean

Gdy ta metoda zostanie zwrócona, zawiera true informację o utworzeniu zdarzenia lokalnego (czyli jeśli name jest to null ciąg pusty) lub jeśli zostało utworzone określone nazwane zdarzenie systemowe; false jeśli określone nazwane zdarzenie systemowe już istniało. Ten parametr jest przekazywany jako niezainicjowany.

Wyjątki

IOException

Nazwa name jest niepoprawna. Może to być z różnych powodów, w tym niektóre ograniczenia, które mogą zostać wprowadzone przez system operacyjny, takie jak nieznany prefiks lub nieprawidłowe znaki. Należy pamiętać, że nazwy i typowe prefiksy "Global\" i "Local\" są uwzględniane wielkość liter.

-lub-

Wystąpił inny błąd. Właściwość HResult może dostarczyć więcej informacji.

DirectoryNotFoundException

Tylko system Windows: name określono nieznaną przestrzeń nazw. Aby uzyskać więcej informacji, zobacz Nazwy obiektów .

PathTooLongException

Jest name za długi. Ograniczenia długości mogą zależeć od systemu operacyjnego lub konfiguracji.

UnauthorizedAccessException

Nazwane zdarzenie istnieje i ma zabezpieczenia kontroli dostępu, ale użytkownik nie ma FullControl.

WaitHandleCannotBeOpenedException

Nie można utworzyć obiektu synchronizacji z podanym name . Obiekt synchronizacji innego typu może mieć taką samą nazwę.

ArgumentException

Wartość mode wyliczenia była poza zakresem prawnym.

-lub-

Tylko program .NET Framework: name jest dłuższy niż MAX_PATH (260 znaków).

Uwagi

Element name może być poprzedzony prefiksem Global\ lub Local\ w celu określenia przestrzeni nazw. Po określeniu Global przestrzeni nazw obiekt synchronizacji może być współużytkowany z dowolnymi procesami w systemie. Po określeniu Local przestrzeni nazw, która jest również domyślna, gdy nie określono przestrzeni nazw, obiekt synchronizacji może być współużytkowany z procesami w tej samej sesji. W systemie Windows sesja jest sesją logowania, a usługi są zwykle uruchamiane w innej sesji nieinterakcyjnej. W systemach operacyjnych podobnych do systemu Unix każda powłoka ma własną sesję. Obiekty synchronizacji lokalnej sesji mogą być odpowiednie do synchronizowania procesów z relacją nadrzędną/podrzędną, w której wszystkie są uruchamiane w tej samej sesji. Aby uzyskać więcej informacji na temat nazw obiektów synchronizacji w systemie Windows, zobacz Nazwy obiektów.

name Jeśli element jest podany, a obiekt synchronizacji żądanego typu już istnieje w przestrzeni nazw, istniejący obiekt synchronizacji jest otwarty. Jeśli obiekt synchronizacji innego typu już istnieje w przestrzeni nazw, WaitHandleCannotBeOpenedException jest zgłaszany. W przeciwnym razie zostanie utworzony nowy obiekt synchronizacji.

Jeśli zdarzenie systemowe o nazwie określonej dla parametru name już istnieje, initialState parametr jest ignorowany. Po wywołaniu tego konstruktora użyj wartości w zmiennej określonej dla parametru ref (ByRef parametru w Visual Basic),createdNew aby określić, czy nazwane zdarzenie systemowe już istnieje, czy zostało utworzone.

Jeśli początkowy stan zdarzenia jest niepodpisany, wątki oczekujące na zdarzenie będą blokowane. Jeśli stan początkowy jest sygnalizowany, a flaga ManualReset jest określona dla modeelementu , wątki oczekujące na zdarzenie nie będą blokowane. Jeśli stan początkowy zostanie zasygnalizowany i mode jest AutoResetto , pierwszy wątek, który czeka na zdarzenie zostanie zwolniony natychmiast, po którym zdarzenie zostanie zresetowane, a kolejne wątki będą blokowane.

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.

Zobacz też

• Przegląd elementów podstawowych synchronizacji