다음을 통해 공유


Monitor.Wait 메서드

정의

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다.

오버로드

Wait(Object, Int32, Boolean)

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다. 또한 이 메서드는 컨텍스트의 동기화 도메인(동기화된 컨텍스트에 있는 경우)을 대기 전에 종료하고 나중에 다시 가져오는지 여부도 지정합니다.

Wait(Object)

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다.

Wait(Object, Int32)

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다.

Wait(Object, TimeSpan)

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다.

Wait(Object, TimeSpan, Boolean)

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다. 필요에 따라 동기화된 컨텍스트의 동기화 도메인을 대기 전에 종료하고 나중에 해당 도메인을 다시 가져옵니다.

Wait(Object, Int32, Boolean)

Source:
Monitor.cs
Source:
Monitor.cs
Source:
Monitor.cs

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다. 또한 이 메서드는 컨텍스트의 동기화 도메인(동기화된 컨텍스트에 있는 경우)을 대기 전에 종료하고 나중에 다시 가져오는지 여부도 지정합니다.

public:
 static bool Wait(System::Object ^ obj, int millisecondsTimeout, bool exitContext);
public static bool Wait (object obj, int millisecondsTimeout, bool exitContext);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool Wait (object obj, int millisecondsTimeout, bool exitContext);
static member Wait : obj * int * bool -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member Wait : obj * int * bool -> bool
Public Shared Function Wait (obj As Object, millisecondsTimeout As Integer, exitContext As Boolean) As Boolean

매개 변수

obj
Object

대기할 개체입니다.

millisecondsTimeout
Int32

스레드가 준비된 큐에 들어가기 전에 대기할 시간(밀리초)입니다.

exitContext
Boolean

대기 전에 컨텍스트의 동기화 도메인(동기화된 컨텍스트에 있는 경우)을 끝내고 다시 가져오면 true이고, 그렇지 않으면 false입니다.

반환

지정된 시간이 경과하기 전에 잠금을 다시 가져오면 true이고, 지정된 시간이 경과한 후에 잠금을 다시 가져오면 false입니다. 이 메서드는 잠금을 다시 가져올 때까지 반환하지 않습니다.

특성

예외

obj 매개 변수가 null인 경우

Wait가 동기화된 코드 블록 내에서 호출되지 않는 경우

Wait를 호출하는 스레드가 나중에 대기 상태에서 중단된 경우. 이 예외는 다른 스레드가 이 스레드의 Interrupt() 메서드를 호출할 때 발생합니다.

millisecondsTimeout 매개 변수의 값이 음이고 Infinite와 같지 않은 경우

설명

이 API에 대한 자세한 내용은 Monitor.Wait에 대한 추가 API 설명을 참조하세요.

추가 정보

적용 대상

Wait(Object)

Source:
Monitor.cs
Source:
Monitor.cs
Source:
Monitor.cs

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다.

public:
 static bool Wait(System::Object ^ obj);
public static bool Wait (object obj);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool Wait (object obj);
static member Wait : obj -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member Wait : obj -> bool
Public Shared Function Wait (obj As Object) As Boolean

매개 변수

obj
Object

대기할 개체입니다.

반환

지정된 개체 잠금을 호출자가 다시 가져와 호출이 반환되면 true입니다. 잠금을 다시 가져오지 않으면 이 메서드는 반환하지 않습니다.

특성

예외

obj 매개 변수가 null인 경우

호출한 스레드가 지정된 개체 잠금을 소유하지 않는 경우

Wait를 호출하는 스레드가 나중에 대기 상태에서 중단된 경우. 이 예외는 다른 스레드가 이 스레드의 Interrupt() 메서드를 호출할 때 발생합니다.

설명

현재 지정된 개체의 잠금을 소유하고 있는 스레드는 다른 스레드가 액세스할 수 있도록 개체를 해제하기 위해 이 메서드를 호출합니다. 잠금을 다시 가져올 때까지 기다리는 동안 호출자가 차단됩니다. 이 메서드는 호출자가 다른 스레드의 작업 결과로 발생할 상태 변경을 기다려야 할 때 호출됩니다.

스레드가 를 호출 Wait하면 개체에 대한 잠금을 해제하고 개체의 대기 큐에 들어갑니다. 개체의 준비 큐에 있는 다음 스레드(있는 경우)는 잠금을 획득하고 개체를 단독으로 사용합니다. 호출 Wait 하는 모든 스레드는 잠금 소유자가 보낸 또는 PulseAll에서 Pulse 신호를 받을 때까지 대기 큐에 남아 있습니다. 가 전송되면 Pulse 대기 중인 큐의 헤드에 있는 스레드만 영향을 받습니다. 가 전송되면 PulseAll 개체를 기다리는 모든 스레드가 영향을 받습니다. 신호가 수신되면 하나 이상의 스레드가 대기 중인 큐를 떠나 준비 큐를 입력합니다. 준비 큐의 스레드는 잠금을 다시 가져올 수 있습니다.

이 메서드는 호출 스레드가 개체에 대한 잠금을 다시 가져올 때 를 반환합니다. 잠금 소유자에서 또는 PulseAll를 호출 Pulse 하지 않는 경우 이 메서드는 무기한 차단됩니다.

호출자는 지정된 개체에 대해 호출된 횟 Enter 수에 관계없이 한 번 실행됩니다Wait. 개념적으로 메서드는 Wait 호출자가 개체에서 호출한 Enter 횟수를 저장하고 잠긴 개체를 완전히 해제하는 데 필요한 횟수를 호출 Exit 합니다. 그런 다음 호출자는 개체를 다시 가져올 때까지 기다리는 동안 차단합니다. 호출자가 잠금을 다시 가져올 때 시스템은 Enter 호출자에 대해 저장된 Enter 수를 복원하는 데 필요한 횟수를 호출합니다. 를 호출하면 Wait 지정된 개체에 대한 잠금만 해제됩니다. 호출자가 다른 개체에 대한 잠금의 소유자인 경우 이러한 잠금은 해제되지 않습니다.

동기화된 개체에는 현재 잠금이 있는 스레드에 대한 참조, 잠금을 가져올 준비가 된 스레드가 포함된 준비 큐에 대한 참조, 개체 상태 변경 알림을 기다리는 스레드가 포함된 대기 중인 큐에 대한 참조 등 여러 참조가 있습니다.

Pulse동기화된 코드 블록 내에서 , PulseAllWait 메서드를 호출해야 합니다.

메서드에 대한 설명은 스레드가 Pulse 대기하지 않을 때 가 호출되면 Pulse 어떻게 되는지 설명합니다.

추가 정보

적용 대상

Wait(Object, Int32)

Source:
Monitor.CoreCLR.cs
Source:
Monitor.CoreCLR.cs
Source:
Monitor.CoreCLR.cs

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다.

public:
 static bool Wait(System::Object ^ obj, int millisecondsTimeout);
public static bool Wait (object obj, int millisecondsTimeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool Wait (object obj, int millisecondsTimeout);
static member Wait : obj * int -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member Wait : obj * int -> bool
Public Shared Function Wait (obj As Object, millisecondsTimeout As Integer) As Boolean

매개 변수

obj
Object

대기할 개체입니다.

millisecondsTimeout
Int32

스레드가 준비된 큐에 들어가기 전에 대기할 시간(밀리초)입니다.

반환

지정된 시간이 경과하기 전에 잠금을 다시 가져오면 true이고, 지정된 시간이 경과한 후에 잠금을 다시 가져오면 false입니다. 이 메서드는 잠금을 다시 가져올 때까지 반환하지 않습니다.

특성

예외

obj 매개 변수가 null인 경우

호출한 스레드가 지정된 개체 잠금을 소유하지 않는 경우

Wait를 호출하는 스레드가 나중에 대기 상태에서 중단된 경우. 이 예외는 다른 스레드가 이 스레드의 Interrupt() 메서드를 호출할 때 발생합니다.

millisecondsTimeout 매개 변수의 값이 음이고 Infinite와 같지 않은 경우

설명

이 메서드는 매개 변수에 obj 대한 단독 잠금을 다시 가져올 때까지 반환되지 않습니다.

현재 지정된 개체의 잠금을 소유하고 있는 스레드는 다른 스레드가 액세스할 수 있도록 개체를 해제하기 위해 이 메서드를 호출합니다. 잠금을 다시 가져올 때까지 기다리는 동안 호출자가 차단됩니다. 이 메서드는 호출자가 다른 스레드의 작업 결과로 발생할 상태 변경을 기다려야 할 때 호출됩니다.

시간 제한은 다른 스레드가 또는 PulseAll 메서드를 먼저 호출하지 않고 잠금을 해제하는 경우 현재 스레드가 Pulse 무기한 차단되지 않도록 합니다. 또한 스레드를 준비 큐로 이동하여 대기 큐에서 앞에 있는 다른 스레드를 무시하여 잠금을 더 빨리 다시 가져올 수 있습니다. 스레드는 메서드의 Wait 반환 값을 테스트하여 제한 시간 전에 잠금을 다시 입력했는지 여부를 확인할 수 있습니다. 스레드는 대기를 입력한 조건을 평가하고 필요한 경우 메서드를 다시 호출할 Wait 수 있습니다.

스레드가 를 호출 Wait하면 개체에 대한 잠금을 해제하고 개체의 대기 큐에 들어갑니다. 개체의 준비 큐에 있는 다음 스레드(있는 경우)는 잠금을 획득하고 개체를 단독으로 사용합니다. 호출된 Wait 스레드는 잠금을 보유하는 스레드가 를 호출하거나 큐의 다음 스레드이고 잠금을 보유하는 스레드가 를 호출 PulseAll할 때까지 대기 큐에 남아 있습니다 Pulse. 그러나 다른 스레드가 이 개체 Pulse 또는 PulseAll 메서드를 호출하기 전에 경과하면 millisecondsTimeout 잠금을 다시 가져오기 위해 원래 스레드가 준비 큐로 이동됩니다.

참고

가 매개 변수에 millisecondsTimeout 대해 지정된 경우 Infinite 잠금 소유자에서 또는 PulseAll을 호출 Pulse 하지 않는 한 이 메서드는 무기한 차단됩니다. 가 0이면 millisecondsTimeout 를 호출 Wait 하는 스레드가 잠금을 해제한 다음 잠금을 다시 회복하기 위해 즉시 준비 큐에 들어갑니다.

호출자는 지정된 개체에 대해 호출된 횟 Enter 수에 관계없이 한 번 실행됩니다Wait. 개념적으로 메서드는 Wait 호출자가 개체에서 호출한 Enter 횟수를 저장하고 잠긴 개체를 완전히 해제하는 데 필요한 횟수를 호출 Exit 합니다. 그런 다음 호출자는 개체를 다시 가져올 때까지 기다리는 동안 차단합니다. 호출자가 잠금을 다시 가져올 때 시스템은 Enter 호출자에 대해 저장된 Enter 수를 복원하는 데 필요한 횟수를 호출합니다. 를 호출하면 Wait 지정된 개체에 대한 잠금만 해제됩니다. 호출자가 다른 개체에 대한 잠금의 소유자인 경우 이러한 잠금은 해제되지 않습니다.

참고

동기화된 개체에는 현재 잠금을 보유하고 있는 스레드에 대한 참조, 잠금을 가져올 준비가 된 스레드가 포함된 준비 큐에 대한 참조, 개체 상태 변경 알림을 기다리는 스레드가 포함된 대기 중인 큐에 대한 참조 등 여러 참조가 있습니다.

Pulse동기화된 코드 블록 내에서 , PulseAllWait 메서드를 호출해야 합니다.

메서드에 대한 설명은 스레드가 Pulse 대기하지 않을 때 가 호출되면 Pulse 어떻게 되는지 설명합니다.

추가 정보

적용 대상

Wait(Object, TimeSpan)

Source:
Monitor.cs
Source:
Monitor.cs
Source:
Monitor.cs

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다.

public:
 static bool Wait(System::Object ^ obj, TimeSpan timeout);
public static bool Wait (object obj, TimeSpan timeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool Wait (object obj, TimeSpan timeout);
static member Wait : obj * TimeSpan -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member Wait : obj * TimeSpan -> bool
Public Shared Function Wait (obj As Object, timeout As TimeSpan) As Boolean

매개 변수

obj
Object

대기할 개체입니다.

timeout
TimeSpan

스레드가 준비된 큐에 들어가기 전에 대기할 시간을 나타내는 TimeSpan입니다.

반환

지정된 시간이 경과하기 전에 잠금을 다시 가져오면 true이고, 지정된 시간이 경과한 후에 잠금을 다시 가져오면 false입니다. 이 메서드는 잠금을 다시 가져올 때까지 반환하지 않습니다.

특성

예외

obj 매개 변수가 null인 경우

호출한 스레드가 지정된 개체 잠금을 소유하지 않는 경우

Wait를 호출하는 스레드가 나중에 대기 상태에서 중단된 경우. 이 예외는 다른 스레드가 이 스레드의 Interrupt() 메서드를 호출할 때 발생합니다.

매개 변수의 timeout 값(밀리초)은 음수이고(-1밀리초)를 나타내 Infinite 지 않거나 Int32.MaxValue보다 큽니다.

설명

이 메서드는 매개 변수에 obj 대한 단독 잠금을 다시 가져올 때까지 반환되지 않습니다.

현재 지정된 개체의 잠금을 소유하고 있는 스레드는 다른 스레드가 액세스할 수 있도록 개체를 해제하기 위해 이 메서드를 호출합니다. 잠금을 다시 가져올 때까지 기다리는 동안 호출자가 차단됩니다. 이 메서드는 호출자가 다른 스레드의 작업 결과로 발생할 상태 변경을 기다려야 할 때 호출됩니다.

시간 제한은 다른 스레드가 또는 PulseAll 메서드를 먼저 호출하지 않고 잠금을 해제하는 경우 현재 스레드가 Pulse 무기한 차단되지 않도록 합니다. 또한 스레드를 준비 큐로 이동하여 대기 큐에서 앞에 있는 다른 스레드를 무시하여 잠금을 더 빨리 다시 가져올 수 있습니다. 스레드는 메서드의 Wait 반환 값을 테스트하여 제한 시간 전에 잠금을 다시 입력했는지 여부를 확인할 수 있습니다. 스레드는 대기를 입력한 조건을 평가하고 필요한 경우 메서드를 다시 호출할 Wait 수 있습니다.

스레드가 를 호출 Wait하면 개체에 대한 잠금을 해제하고 개체의 대기 큐에 들어갑니다. 개체의 준비 큐에 있는 다음 스레드(있는 경우)는 잠금을 획득하고 개체를 단독으로 사용합니다. 호출된 Wait 스레드는 잠금을 보유하는 스레드가 를 호출하거나 큐의 다음 스레드이고 잠금을 보유하는 스레드가 를 호출 PulseAll할 때까지 대기 큐에 남아 있습니다 Pulse. 그러나 다른 스레드가 이 개체 Pulse 또는 PulseAll 메서드를 호출하기 전에 경과하면 timeout 잠금을 다시 가져오기 위해 원래 스레드가 준비 큐로 이동됩니다.

참고

매개 변수에 TimeSpan 대해 -1밀리초 를 나타내는 를 지정 timeout 하면 잠금 소유자가 또는 PulseAll을 호출 Pulse 하지 않는 한 이 메서드는 무기한 차단됩니다. 가 0밀리초인 경우 timeout 를 호출 Wait 하는 스레드는 잠금을 해제한 다음 잠금을 다시 회복하기 위해 즉시 준비 큐에 들어갑니다.

호출자는 지정된 개체에 대해 호출된 횟 Enter 수에 관계없이 한 번 실행됩니다Wait. 개념적으로 메서드는 Wait 호출자가 개체에서 호출한 Enter 횟수를 저장하고 잠긴 개체를 완전히 해제하는 데 필요한 횟수를 호출 Exit 합니다. 그런 다음 호출자는 개체를 다시 가져올 때까지 기다리는 동안 차단합니다. 호출자가 잠금을 다시 가져올 때 시스템은 Enter 호출자에 대해 저장된 Enter 수를 복원하는 데 필요한 횟수를 호출합니다. 를 호출하면 Wait 지정된 개체에 대한 잠금만 해제됩니다. 호출자가 다른 개체에 대한 잠금의 소유자인 경우 이러한 잠금은 해제되지 않습니다.

참고

동기화된 개체에는 현재 잠금을 보유하고 있는 스레드에 대한 참조, 잠금을 가져올 준비가 된 스레드가 포함된 준비 큐에 대한 참조, 개체 상태 변경 알림을 기다리는 스레드가 포함된 대기 중인 큐에 대한 참조 등 여러 참조가 있습니다.

Pulse동기화된 코드 블록 내에서 , PulseAllWait 메서드를 호출해야 합니다.

메서드에 대한 설명은 스레드가 Pulse 대기하지 않을 때 가 호출되면 Pulse 어떻게 되는지 설명합니다.

추가 정보

적용 대상

Wait(Object, TimeSpan, Boolean)

Source:
Monitor.cs
Source:
Monitor.cs
Source:
Monitor.cs

개체의 잠금을 해제한 다음 잠금을 다시 가져올 때까지 현재 스레드를 차단합니다. 지정된 시간 제한 간격이 지나면 스레드가 준비된 큐에 들어갑니다. 필요에 따라 동기화된 컨텍스트의 동기화 도메인을 대기 전에 종료하고 나중에 해당 도메인을 다시 가져옵니다.

public:
 static bool Wait(System::Object ^ obj, TimeSpan timeout, bool exitContext);
public static bool Wait (object obj, TimeSpan timeout, bool exitContext);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool Wait (object obj, TimeSpan timeout, bool exitContext);
static member Wait : obj * TimeSpan * bool -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member Wait : obj * TimeSpan * bool -> bool
Public Shared Function Wait (obj As Object, timeout As TimeSpan, exitContext As Boolean) As Boolean

매개 변수

obj
Object

대기할 개체입니다.

timeout
TimeSpan

스레드가 준비된 큐에 들어가기 전에 대기할 시간을 나타내는 TimeSpan입니다.

exitContext
Boolean

대기 전에 컨텍스트의 동기화 도메인(동기화된 컨텍스트에 있는 경우)을 끝내고 다시 가져오면 true이고, 그렇지 않으면 false입니다.

반환

지정된 시간이 경과하기 전에 잠금을 다시 가져오면 true이고, 지정된 시간이 경과한 후에 잠금을 다시 가져오면 false입니다. 이 메서드는 잠금을 다시 가져올 때까지 반환하지 않습니다.

특성

예외

obj 매개 변수가 null인 경우

Wait가 동기화된 코드 블록 내에서 호출되지 않는 경우

Wait를 호출하는 스레드가 나중에 대기 상태에서 중단된 경우. 이 예외는 다른 스레드가 이 스레드의 Interrupt() 메서드를 호출할 때 발생합니다.

timeout 매개 변수가 음수이고 (-1밀리초)를 나타내 Infinite 지 않거나 Int32.MaxValue보다 큽니까.

설명

이 API에 대한 자세한 내용은 Monitor.Wait에 대한 추가 API 설명을 참조하세요.

추가 정보

적용 대상