이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

EventWaitHandle 클래스

 

게시 날짜: 2016년 11월

스레드 동기화 이벤트를 나타냅니다.

네임스페이스:   System.Threading
어셈블리:  mscorlib(mscorlib.dll에 있음)

System.Object
  System.MarshalByRefObject
    System.Threading.WaitHandle
      System.Threading.EventWaitHandle
        System.Threading.AutoResetEvent
        System.Threading.ManualResetEvent

[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true, 
	ExternalThreading = true)]
public class EventWaitHandle : WaitHandle

이름설명
System_CAPS_pubmethodEventWaitHandle(Boolean, EventResetMode)

새 인스턴스를 초기화는 EventWaitHandle 대기 핸들 처음 신호 여부 및 자동 또는 수동으로 재설정 하는지 여부를 지정 하는 클래스입니다.

System_CAPS_pubmethodEventWaitHandle(Boolean, EventResetMode, String)

새 인스턴스를 초기화는 EventWaitHandle 알리는지 여부를 대기 핸들은 처음에이 호출의 결과로 만들어진 자동 또는 수동으로 다시 설정 하는지 여부를 지정 하는 클래스 및 시스템 동기화 이벤트의 이름입니다.

System_CAPS_pubmethodEventWaitHandle(Boolean, EventResetMode, String, Boolean)

이 호출의 결과로 대기 핸들이 초기에 신호를 받는지 여부, 자동으로 재설정되는지 또는 수동으로 재설정되는지, 시스템 동기화 이벤트의 이름, 호출 후에 해당 값이 명명된 시스템 이벤트가 생성되었는지 여부를 나타내는 부울 변수를 지정하여 EventWaitHandle 클래스의 새 인스턴스를 초기화합니다.

System_CAPS_pubmethodEventWaitHandle(Boolean, EventResetMode, String, Boolean, EventWaitHandleSecurity)

이 호출의 결과로 대기 핸들이 초기에 신호를 받는지 여부, 자동으로 재설정되는지 또는 수동으로 재설정되는지, 시스템 동기화 이벤트의 이름, 호출 후에 해당 값이 명명된 시스템 이벤트가 생성되었는지 여부를 나타내는 부울 변수, 생성되는 경우 명명된 이벤트에 적용될 액세스 제어 보안을 지정하여 EventWaitHandle 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyHandle

사용되지 않습니다. 네이티브 운영 체제 핸들을 가져오거나 설정합니다.(WaitHandle에서 상속됨)

System_CAPS_pubpropertySafeWaitHandle

네이티브 운영 체제 핸들을 가져오거나 설정합니다.(WaitHandle에서 상속됨)

이름설명
System_CAPS_pubmethodClose()

현재 WaitHandle이 사용 중인 모든 리소스를 해제합니다. (WaitHandle에서 상속됨)

System_CAPS_pubmethodCreateObjRef(Type)

원격 개체와 통신 하는 데 프록시를 생성 하는 데 필요한 모든 관련 정보를 포함 하는 개체를 만듭니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodDispose()

WaitHandle 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.(WaitHandle에서 상속됨)

System_CAPS_protmethodDispose(Boolean)

파생 클래스에서 재정의된 경우 WaitHandle에서 사용하는 관리되지 않는 리소스를 해제하고 필요에 따라 관리되는 리소스를 해제합니다.(WaitHandle에서 상속됨)

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)

System_CAPS_protmethodFinalize()

개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)

System_CAPS_pubmethodGetAccessControl()

현재 EventWaitHandle 개체로 표시되는 명명된 시스템 이벤트에 대한 액세스 제어 보안을 나타내는 EventWaitHandleSecurity 개체를 가져옵니다.

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다.(Object에서 상속됨)

System_CAPS_pubmethodGetLifetimeService()

이 인스턴스에 대 한 수명 정책을 제어 하는 수명이 현재 서비스 개체를 검색 합니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodInitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.(MarshalByRefObject에서 상속됨)

System_CAPS_protmethodMemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.(Object에서 상속됨)

System_CAPS_protmethodMemberwiseClone(Boolean)

현재의 단순 복사본을 만듭니다 MarshalByRefObject 개체입니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodSystem_CAPS_staticOpenExisting(String)

이미 있는 경우 지정한 명명 된 동기화 이벤트를 엽니다.

System_CAPS_pubmethodSystem_CAPS_staticOpenExisting(String, EventWaitHandleRights)

지정한 이미 있는 경우, 원하는 보안 액세스로 명명 된 동기화 이벤트를 엽니다.

System_CAPS_pubmethodReset()

이벤트 상태를 신호 없음으로 설정하여 스레드가 차단되도록 합니다.

System_CAPS_pubmethodSet()

하나 이상의 대기 중인 스레드를 진행할 수 있도록 이벤트 상태를 신호 받음으로 설정합니다.

System_CAPS_pubmethodSetAccessControl(EventWaitHandleSecurity)

명명된 시스템 이벤트에 대해 액세스 제어 보안을 설정합니다.

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨)

System_CAPS_pubmethodSystem_CAPS_staticTryOpenExisting(String, EventWaitHandle)

지정한 명명된 동기화 이벤트(이미 존재하는 경우)를 열고 작업이 성공했는지를 나타내는 값을 반환합니다.

System_CAPS_pubmethodSystem_CAPS_staticTryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)

지정한 명명된 동기화 이벤트(이미 존재하는 경우)를 원하는 보안 액세스로 열고 작업이 성공적으로 수행되었는지 여부를 나타내는 값을 반환합니다.

System_CAPS_pubmethodWaitOne()

현재 WaitHandle이(가) 신호를 받을 때까지 현재 스레드를 차단합니다.(WaitHandle에서 상속됨)

System_CAPS_pubmethodWaitOne(Int32)

부호 있는 32비트 정수로 시간 간격(밀리초)을 지정하여 현재 WaitHandle이 신호를 받을 때까지 현재 스레드를 차단합니다.(WaitHandle에서 상속됨)

System_CAPS_pubmethodWaitOne(Int32, Boolean)

부호 있는 32비트 정수로 시간 간격을 지정하고 대기 전에 동기화 도메인을 끝낼지 여부를 지정하여 현재 WaitHandle이 신호를 받을 때까지 현재 스레드를 차단합니다.(WaitHandle에서 상속됨)

System_CAPS_pubmethodWaitOne(TimeSpan)

TimeSpan로 시간 간격을 지정하여 현재 인스턴스가 신호를 받을 때까지 현재 스레드를 차단합니다.(WaitHandle에서 상속됨)

System_CAPS_pubmethodWaitOne(TimeSpan, Boolean)

TimeSpan로 시간 간격을 지정하고 대기 전에 동기화 도메인을 끝낼지 여부를 지정하여 현재 인스턴스가 신호를 받을 때까지 현재 스레드를 차단합니다.(WaitHandle에서 상속됨)

이름설명
System_CAPS_pubmethodGetSafeWaitHandle()

네이티브 운영 체제 대기 핸들에 대 한 안전한 핸들을 가져옵니다.(WaitHandleExtensions에서 정의됨)

System_CAPS_pubmethodSetSafeWaitHandle(SafeWaitHandle)

네이티브 운영 체제 대기 핸들에 대 한 안전한 핸들을 설정합니다.(WaitHandleExtensions에서 정의됨)

The T:System.Threading.EventWaitHandle class allows threads to communicate with each other by signaling. Typically, one or more threads block on an T:System.Threading.EventWaitHandle until an unblocked thread calls the M:System.Threading.EventWaitHandle.Set method, releasing one or more of the blocked threads. A thread can signal an T:System.Threading.EventWaitHandle and then block on it, by calling the static (Shared in Visual Basic) Overload:System.Threading.WaitHandle.SignalAndWait method.

System_CAPS_note참고

The T:System.Threading.EventWaitHandle class provides access to named system synchronization events.

The behavior of an T:System.Threading.EventWaitHandle that has been signaled depends on its reset mode. An T:System.Threading.EventWaitHandle created with the F:System.Threading.EventResetMode.AutoReset flag resets automatically when signaled, after releasing a single waiting thread. An T:System.Threading.EventWaitHandle created with the F:System.Threading.EventResetMode.ManualReset flag remains signaled until its M:System.Threading.EventWaitHandle.Reset method is called.

Automatic reset events provide exclusive access to a resource. If an automatic reset event is signaled when no threads are waiting, it remains signaled until a thread attempts to wait on it. The event releases the thread and immediately resets, blocking subsequent threads.

Manual reset events are like gates. When the event is not signaled, threads that wait on it will block. When the event is signaled, all waiting threads are released, and the event remains signaled (that is, subsequent waits do not block) until its M:System.Threading.EventWaitHandle.Reset method is called. Manual reset events are useful when one thread must complete an activity before other threads can proceed.

EventWaitHandle objects can be used with the static(Shared in Visual Basic) WaitHandle.WaitAll and WaitHandle.WaitAny methods.

For more information about thread synchronization mechanisms, see EventWaitHandle, AutoResetEvent, and ManualResetEvent.

The following code example uses the M:System.Threading.WaitHandle.SignalAndWait(System.Threading.WaitHandle,System.Threading.WaitHandle) method overload to allow the main thread to signal a blocked thread and then wait until the thread finishes a task.

The example starts five threads and allows them to block on an T:System.Threading.EventWaitHandle created with the F:System.Threading.EventResetMode.AutoReset flag, then releases one thread each time the user presses the ENTER key. The example then queues another five threads and releases them all using an T:System.Threading.EventWaitHandle created with the F:System.Threading.EventResetMode.ManualReset flag.

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

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
2.0 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
Windows Phone
8.1 이후 사용 가능

This type is thread safe.

맨 위로 이동
표시: