WaitHandle 클래스

정의

네임스페이스:

System.Threading

어셈블리:

netstandard.dll, System.Runtime.dll

Source:

WaitHandle.cs

공유 리소스에 대한 단독 액세스를 기다리는 운영 체제별 개체를 캡슐화합니다.

public ref class WaitHandle abstract : MarshalByRefObject, IDisposable

public abstract class WaitHandle : MarshalByRefObject, IDisposable

type WaitHandle = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class WaitHandle
Inherits MarshalByRefObject
Implements IDisposable

상속

Object

MarshalByRefObject

WaitHandle

파생

System.Threading.EventWaitHandle

System.Threading.Mutex

System.Threading.Semaphore

구현

IDisposable

예제

다음 코드 예제에서는 주 스레드가 클래스의 WaitHandle 정적 WaitAny 및 WaitAll 메서드를 사용하여 태스크가 완료되기를 기다리는 동안 두 스레드가 백그라운드 작업을 수행하는 방법을 보여 줍니다.

using System;
using System.Threading;

public sealed class App
{
    // Define an array with two AutoResetEvent WaitHandles.
    static WaitHandle[] waitHandles = new WaitHandle[]
    {
        new AutoResetEvent(false),
        new AutoResetEvent(false)
    };

    // Define a random number generator for testing.
    static Random r = new Random();

    static void Main()
    {
        // Queue up two tasks on two different threads;
        // wait until all tasks are completed.
        DateTime dt = DateTime.Now;
        Console.WriteLine("Main thread is waiting for BOTH tasks to complete.");
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[0]);
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[1]);
        WaitHandle.WaitAll(waitHandles);
        // The time shown below should match the longest task.
        Console.WriteLine("Both tasks are completed (time waited={0})",
            (DateTime.Now - dt).TotalMilliseconds);

        // Queue up two tasks on two different threads;
        // wait until any task is completed.
        dt = DateTime.Now;
        Console.WriteLine();
        Console.WriteLine("The main thread is waiting for either task to complete.");
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[0]);
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[1]);
        int index = WaitHandle.WaitAny(waitHandles);
        // The time shown below should match the shortest task.
        Console.WriteLine("Task {0} finished first (time waited={1}).",
            index + 1, (DateTime.Now - dt).TotalMilliseconds);
    }

    static void DoTask(Object state)
    {
        AutoResetEvent are = (AutoResetEvent) state;
        int time = 1000 * r.Next(2, 10);
        Console.WriteLine("Performing a task for {0} milliseconds.", time);
        Thread.Sleep(time);
        are.Set();
    }
}

// This code produces output similar to the following:
//
//  Main thread is waiting for BOTH tasks to complete.
//  Performing a task for 7000 milliseconds.
//  Performing a task for 4000 milliseconds.
//  Both tasks are completed (time waited=7064.8052)
//
//  The main thread is waiting for either task to complete.
//  Performing a task for 2000 milliseconds.
//  Performing a task for 2000 milliseconds.
//  Task 1 finished first (time waited=2000.6528).

Imports System.Threading

NotInheritable Public Class App
    ' Define an array with two AutoResetEvent WaitHandles.
    Private Shared waitHandles() As WaitHandle = _
        {New AutoResetEvent(False), New AutoResetEvent(False)}
    
    ' Define a random number generator for testing.
    Private Shared r As New Random()
    
    <MTAThreadAttribute> _
    Public Shared Sub Main() 
        ' Queue two tasks on two different threads; 
        ' wait until all tasks are completed.
        Dim dt As DateTime = DateTime.Now
        Console.WriteLine("Main thread is waiting for BOTH tasks to complete.")
        ThreadPool.QueueUserWorkItem(AddressOf DoTask, waitHandles(0))
        ThreadPool.QueueUserWorkItem(AddressOf DoTask, waitHandles(1))
        WaitHandle.WaitAll(waitHandles)
        ' The time shown below should match the longest task.
        Console.WriteLine("Both tasks are completed (time waited={0})", _
            (DateTime.Now - dt).TotalMilliseconds)
        
        ' Queue up two tasks on two different threads; 
        ' wait until any tasks are completed.
        dt = DateTime.Now
        Console.WriteLine()
        Console.WriteLine("The main thread is waiting for either task to complete.")
        ThreadPool.QueueUserWorkItem(AddressOf DoTask, waitHandles(0))
        ThreadPool.QueueUserWorkItem(AddressOf DoTask, waitHandles(1))
        Dim index As Integer = WaitHandle.WaitAny(waitHandles)
        ' The time shown below should match the shortest task.
        Console.WriteLine("Task {0} finished first (time waited={1}).", _
            index + 1,(DateTime.Now - dt).TotalMilliseconds)
    
    End Sub
    
    Shared Sub DoTask(ByVal state As [Object]) 
        Dim are As AutoResetEvent = CType(state, AutoResetEvent)
        Dim time As Integer = 1000 * r.Next(2, 10)
        Console.WriteLine("Performing a task for {0} milliseconds.", time)
        Thread.Sleep(time)
        are.Set()
    
    End Sub
End Class

' This code produces output similar to the following:
'
'  Main thread is waiting for BOTH tasks to complete.
'  Performing a task for 7000 milliseconds.
'  Performing a task for 4000 milliseconds.
'  Both tasks are completed (time waited=7064.8052)
' 
'  The main thread is waiting for either task to complete.
'  Performing a task for 2000 milliseconds.
'  Performing a task for 2000 milliseconds.
'  Task 1 finished first (time waited=2000.6528).

설명

클래스는 네이 WaitHandle 티브 운영 체제 동기화 핸들을 캡슐화하고 여러 대기 작업을 허용하는 런타임의 모든 동기화 개체를 나타내는 데 사용됩니다. 대기 핸들을 다른 동기화 개체와 비교하려면 동기화 기본 형식 개요를 참조하세요.

WaitHandle 클래스 자체는 추상적입니다. 파생된 WaitHandle 클래스는 공유 리소스에 대한 액세스를 가져오거나 해제함을 나타내는 신호 메커니즘을 정의하지만 상속된 WaitHandle 메서드를 사용하여 공유 리소스에 대한 액세스를 기다리는 동안 차단합니다. 파생된 WaitHandle 클래스는 다음과 같습니다.

• 클래스입니다 Mutex . 뮤텍스를 참조하세요.

• EventWaitHandle 클래스 및 해당 파생 클래스 및 ManualResetEvent. AutoResetEvent

• 클래스입니다 Semaphore . 세마포 및 세마포Slim을 참조하세요.

스레드는 파생된 클래스에서 상속되는 인스턴스 메서드 WaitOne를 호출하여 개별 대기 핸들에서 WaitHandle차단할 수 있습니다.

파생 클래스의 WaitHandle 스레드 선호도는 다릅니다. 이벤트 대기 핸들(EventWaitHandle및 AutoResetEvent) 및 ManualResetEvent세마포에는 스레드 선호도가 없습니다. 모든 스레드는 이벤트 대기 핸들 또는 세마포에 신호를 보낼 수 있습니다. 반면에 뮤텍스에는 스레드 선호도가 있습니다. 뮤텍스를 소유하는 스레드는 뮤텍스를 해제해야 하며, 스레드가 소유하지 않은 뮤텍스에서 메서드를 호출 ReleaseMutex 하면 예외가 throw됩니다.

클래스에서 WaitHandle 파생 MarshalByRefObject되므로 이러한 클래스를 사용하여 애플리케이션 도메인 경계를 넘어 스레드의 활동을 동기화할 수 있습니다.

파생 클래스 WaitHandle 외에도 하나 이상의 동기화 개체가 신호를 받을 때까지 스레드를 차단하는 여러 정적 메서드가 클래스에 있습니다. 여기에는 다음이 포함됩니다.

• SignalAndWait- 스레드가 대기 핸들에 신호를 표시하고 다른 대기 핸들을 즉시 대기할 수 있도록 합니다.

• WaitAll- 배열의 모든 대기 핸들이 신호를 받을 때까지 스레드가 대기할 수 있도록 합니다.

• WaitAny- 지정된 대기 핸들 집합 중 하나가 신호를 보낼 때까지 스레드가 대기할 수 있도록 합니다.

이러한 메서드의 오버로드는 대기를 중단하기 위한 시간 제한 간격과 대기를 입력하기 전에 동기화 컨텍스트를 종료할 수 있는 기회를 제공하여 다른 스레드가 동기화 컨텍스트를 사용할 수 있도록 합니다.

중요합니다

이 형식은 IDisposable 인터페이스를 구현합니다. 형식 또는 파생된 형식 사용을 완료한 경우 직접 또는 간접적으로 삭제해야 합니다. 형식을 직접 삭제하려면 Closetry/ 블록에서 해당 catch 메서드를 호출합니다. 간접적으로 삭제하려면 using(C#) 또는 Using(Visual Basic)와 같은 언어 구문을 사용합니다. 자세한 내용은 인터페이스 항목의 "IDisposable을 구현하는 개체 사용" 섹션을 IDisposable 참조하세요.

WaitHandle 는 패턴을 구현합니다 Dispose . Dispose 메서드 구현을 참조하세요. 파생 WaitHandle되는 경우 속성을 사용하여 네이 SafeWaitHandle 티브 운영 체제 핸들을 저장합니다. 관리되지 않는 추가 리소스를 사용하지 않는 한 보호된 Dispose 메서드를 재정의할 필요가 없습니다.

생성자

Name	Description
WaitHandle()	WaitHandle 클래스의 새 인스턴스를 초기화합니다.

필드

Name	Description
InvalidHandle	잘못된 네이티브 운영 체제 핸들을 나타냅니다. 이 필드는 읽기 전용입니다.
WaitTimeout	대기 핸들이 WaitAny(WaitHandle[], Int32, Boolean) 신호를 받기 전에 작업 시간이 초과되었음을 나타냅니다. 이 필드는 상수입니다.

속성

Name	Description
Handle	사용되지 않음. 네이티브 운영 체제 핸들을 가져오거나 설정합니다.
SafeWaitHandle	네이티브 운영 체제 핸들을 가져오거나 설정합니다.

메서드

Name	Description
Close()	현재 WaitHandle에서 보유한 모든 리소스를 해제합니다.
Dispose()	WaitHandle 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.
Dispose(Boolean)	파생 클래스에서 재정의되는 경우 관리되지 않는 리소스를 WaitHandle해제하고 관리되는 리소스를 선택적으로 해제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
InitializeLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
SignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)	대기 WaitHandle 를 입력하기 전에 시간 제한 간격을 32비트 부호 있는 정수로 지정하고 컨텍스트에 대한 동기화 도메인을 종료할지 여부를 지정하여 신호를 받고 다른 신호를 대기합니다.
SignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)	대기를 입력하기 전에 시간 WaitHandle 제한 간격을 a TimeSpan 로 지정하고 컨텍스트에 대한 동기화 도메인을 종료할지 여부를 지정하여 신호를 받고 다른 신호를 대기합니다.
SignalAndWait(WaitHandle, WaitHandle)	신호를 받고 WaitHandle 다른 신호를 기다립니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
WaitAll(WaitHandle[], Int32, Boolean)	값을 사용하여 Int32 시간 간격을 지정하고 대기 전에 동기화 도메인을 종료할지 여부를 지정하여 지정된 배열의 모든 요소가 신호를 받을 때까지 기다립니다.
WaitAll(WaitHandle[], Int32)	값을 사용하여 Int32 시간 간격을 지정하여 지정된 배열의 모든 요소가 신호를 받을 때까지 기다립니다.
WaitAll(WaitHandle[], TimeSpan, Boolean)	지정된 배열의 모든 요소가 신호를 받을 때까지 대기하고, 값을 사용하여 TimeSpan 시간 간격을 지정하고, 대기 전에 동기화 도메인을 종료할지 여부를 지정합니다.
WaitAll(WaitHandle[], TimeSpan)	지정된 배열의 모든 요소가 시간 간격을 지정하는 값을 사용하여 TimeSpan 신호를 받을 때까지 기다립니다.
WaitAll(WaitHandle[])	지정된 배열의 모든 요소가 신호를 받을 때까지 기다립니다.
WaitAny(WaitHandle[], Int32, Boolean)	32비트 부호 있는 정수를 사용하여 시간 간격을 지정하고 대기 전에 동기화 도메인을 종료할지 여부를 지정하여 지정된 배열의 요소가 신호를 받을 때까지 기다립니다.
WaitAny(WaitHandle[], Int32)	32비트 부호 있는 정수를 사용하여 시간 간격을 지정하여 지정된 배열의 모든 요소가 신호를 받을 때까지 기다립니다.
WaitAny(WaitHandle[], TimeSpan, Boolean)	지정된 배열의 요소가 신호를 받을 때까지 대기합니다. a를 TimeSpan 사용하여 시간 간격을 지정하고 대기 전에 동기화 도메인을 종료할지 여부를 지정합니다.
WaitAny(WaitHandle[], TimeSpan)	지정된 배열의 모든 요소가 시간 간격을 지정하는 데 사용하여 TimeSpan 신호를 받을 때까지 기다립니다.
WaitAny(WaitHandle[])	지정된 배열의 모든 요소가 신호를 받을 때까지 기다립니다.
WaitOne()	현재 스레드가 신호를 받을 때까지 현재 WaitHandle 스레드를 차단합니다.
WaitOne(Int32, Boolean)	32비트 부호 있는 정수를 사용하여 시간 간격을 지정하고 대기 전에 동기화 도메인을 종료할지 여부를 지정하여 현재 스레드가 신호를 받을 때까지 현재 WaitHandle 스레드를 차단합니다.
WaitOne(Int32)	32비트 부호 있는 정수를 사용하여 시간 간격을 밀리초 단위로 지정하여 현재 스레드가 신호를 받을 때까지 현재 WaitHandle 스레드를 차단합니다.
WaitOne(TimeSpan, Boolean)	시간 간격을 지정하고 대기 전에 동기화 도메인을 종료할지 여부를 지정하여 현재 인스턴스가 신호를 TimeSpan 받을 때까지 현재 스레드를 차단합니다.
WaitOne(TimeSpan)	시간 간격을 지정하여 현재 인스턴스가 신호를 받을 때까지 현재 스레드를 TimeSpan 차단합니다.

확장명 메서드

Name	Description
GetSafeWaitHandle(WaitHandle)	네이티브 운영 체제 대기 핸들에 대한 안전 핸들을 가져옵니다.
SetSafeWaitHandle(WaitHandle, SafeWaitHandle)	네이티브 운영 체제 대기 핸들에 대한 안전 핸들을 설정합니다.

스레드 보안

이 형식은 스레드로부터 안전합니다.

추가 정보

• 스레딩
• 스레드 개체 및 기능
• 뮤텍스
• EventWaitHandle, AutoResetEvent 및 ManualResetEvent
• 세마포