WaitHandle.SignalAndWait Yöntem

Tanım

Ad Alanı:

System.Threading

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Bir sinyal WaitHandle alır ve diğerini bekler.

Aşırı Yüklemeler

Name	Description
SignalAndWait(WaitHandle, WaitHandle)	Bir sinyal WaitHandle alır ve diğerini bekler.
SignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)	Bir sinyal WaitHandle gönderir ve diğerinde bekler, zaman aşımı aralığını 32 bit işaretli bir tamsayı olarak belirtir ve beklemeye girmeden önce bağlam için eşitleme etki alanından çıkılıp çıkılmayacağını belirtir.
SignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)	Bir sinyal gönderir WaitHandle ve diğerinde bekler, zaman aşımı aralığını olarak TimeSpan belirtir ve beklemeye girmeden önce bağlam için eşitleme etki alanından çıkılıp çıkılmayacağını belirtir.

SignalAndWait(WaitHandle, WaitHandle)

Kaynak:

WaitHandle.cs

Bir sinyal WaitHandle alır ve diğerini bekler.

public:
 static bool SignalAndWait(System::Threading::WaitHandle ^ toSignal, System::Threading::WaitHandle ^ toWaitOn);

public static bool SignalAndWait(System.Threading.WaitHandle toSignal, System.Threading.WaitHandle toWaitOn);

static member SignalAndWait : System.Threading.WaitHandle * System.Threading.WaitHandle -> bool

Public Shared Function SignalAndWait (toSignal As WaitHandle, toWaitOn As WaitHandle) As Boolean

Parametreler

toSignal

WaitHandle

Sinyale WaitHandle .

toWaitOn

WaitHandle

WaitHandle Beklemek için.

Döndürülenler

Boolean

true hem sinyal hem de bekleme başarıyla tamamlanırsa; bekleme tamamlanmazsa, yöntemi döndürmez.

Özel durumlar

ArgumentNullException

toSignal, null'e eşittir.

-veya-

toWaitOn, null'e eşittir.

NotSupportedException

yöntemi durumundaki bir iş parçacığında STA çağrıldı.

InvalidOperationException

toSignal bir semafordur ve zaten tam sayıya sahiptir.

AbandonedMutexException

Bir iş parçacığı bir mutex serbest bırakmadan çıktığı için bekleme tamamlandı.

Örnekler

Aşağıdaki kod örneği, ana iş parçacığının SignalAndWait(WaitHandle, WaitHandle) engellenen bir iş parçacığına sinyal göndermesine ve ardından iş parçacığının görevi bitirmesini beklemesine izin vermek için yöntem aşırı yüklemesini kullanır.

Örnek beş iş parçacığı başlatır, bayrağıyla oluşturulan bir EventWaitHandle iş parçacığını EventResetMode.AutoReset engellemelerine olanak tanır ve kullanıcı ENTER tuşuna her bastığında bir iş parçacığı serbest bırakır. Örnek daha sonra beş iş parçacığını daha kuyruğa alır ve bayrağıyla EventWaitHandle oluşturulan bir EventResetMode.ManualReset kullanarak bunların tümünü serbest bırakır.

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

Açıklamalar

Bu işlemin atomik olması garanti değildir. Geçerli iş parçacığı sinyal verdikten toSignal sonra ancak üzerinde toWaitOnbeklemeden önce, başka bir işlemcide çalışan bir iş parçacığı sinyal toWaitOn verebilir veya üzerinde bekleyebilir.

SignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)

Kaynak:

WaitHandle.cs

Bir sinyal WaitHandle gönderir ve diğerinde bekler, zaman aşımı aralığını 32 bit işaretli bir tamsayı olarak belirtir ve beklemeye girmeden önce bağlam için eşitleme etki alanından çıkılıp çıkılmayacağını belirtir.

public:
 static bool SignalAndWait(System::Threading::WaitHandle ^ toSignal, System::Threading::WaitHandle ^ toWaitOn, int millisecondsTimeout, bool exitContext);

public static bool SignalAndWait(System.Threading.WaitHandle toSignal, System.Threading.WaitHandle toWaitOn, int millisecondsTimeout, bool exitContext);

static member SignalAndWait : System.Threading.WaitHandle * System.Threading.WaitHandle * int * bool -> bool

Public Shared Function SignalAndWait (toSignal As WaitHandle, toWaitOn As WaitHandle, millisecondsTimeout As Integer, exitContext As Boolean) As Boolean

Parametreler

toSignal

WaitHandle

Sinyale WaitHandle .

toWaitOn

WaitHandle

WaitHandle Beklemek için.

millisecondsTimeout

Int32

Bekleyebilecek aralığı temsil eden bir tamsayı. Değer ise Infinite, yani -1 ise, bekleme sonsuzdur.

exitContext

Boolean

true beklemeden önce bağlam için eşitleme etki alanından çıkmak (eşitlenmiş bir bağlamdaysa) ve daha sonra yeniden almak; aksi takdirde , false.

Döndürülenler

Boolean

true hem sinyal hem de bekleme başarıyla tamamlandıysa veya false sinyal tamamlandıysa ancak bekleme zaman aşımına uğradıysa.

Özel durumlar

ArgumentNullException

toSignal, null'e eşittir.

-veya-

toWaitOn, null'e eşittir.

NotSupportedException

yöntemi durumundaki bir iş parçacığında STA çağrılır.

InvalidOperationException

WaitHandle maksimum sayısını aşacağından sinyal verilemiyor.

ArgumentOutOfRangeException

millisecondsTimeout , -1 dışında bir negatif sayıdır ve bu da sonsuz zaman aşımını temsil eder.

AbandonedMutexException

Bir iş parçacığı bir mutex serbest bırakmadan çıktığı için bekleme tamamlandı.

Açıklamalar

Bu işlemin atomik olması garanti değildir. Geçerli iş parçacığı sinyal verdikten toSignal sonra ancak üzerinde toWaitOnbeklemeden önce, başka bir işlemcide çalışan bir iş parçacığı sinyal toWaitOn verebilir veya üzerinde bekleyebilir.

Sıfır ise millisecondsTimeout , yöntemi engellemez. durumunu toWaitOn test eder ve hemen döndürür.

Bağlamdan çıkma

Bu exitContext yöntem, bilinmeyen bir yönetilen bağlamın içinden çağrılmadığı sürece parametresinin hiçbir etkisi yoktur. İş parçacığınız öğesinden ContextBoundObjecttüretilen bir sınıfın örneğine yönelik bir çağrının içindeyse yönetilen bağlam uyumsuz olabilir. şu anda gibi öğesinden ContextBoundObjectStringtüretilmemiş bir sınıfta bir yöntem yürütüyor olsanız bile, geçerli uygulama etki alanındaki yığınınızda bir varsaContextBoundObject, uyumsuz bir bağlamda olabilirsiniz.

Kodunuz bilinmeyen bir bağlamda yürütülürken, öğesinin true belirtilmesiexitContext, bu yöntemi yürütmeden önce iş parçacığının bilinmeyen yönetilen bağlamdan (yani varsayılan bağlama geçiş için) çıkmasına neden olur. İş parçacığı, bu yönteme yapılan çağrı tamamlandıktan sonra özgün bilinmeyen bağlama döner.

Bağlama bağlı sınıf özniteliğine sahip olduğunda bağlamdan SynchronizationAttribute çıkmak yararlı olabilir. Bu durumda, sınıfın üyelerine yapılan tüm çağrılar otomatik olarak eşitlenir ve eşitleme etki alanı sınıfın kod gövdesinin tamamıdır. Bir üyenin çağrı yığınındaki kod bu yöntemi çağırır ve için truebelirtirseexitContext, iş parçacığı eşitleme etki alanından çıkar ve nesnenin herhangi bir üyesine yapılan çağrıda engellenen bir iş parçacığının devam etmesini sağlar. Bu yöntem döndürdüğünde, çağrıyı yapan iş parçacığı eşitleme etki alanını yeniden eklemek için beklemelidir.

SignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)

Kaynak:

WaitHandle.cs

Bir sinyal gönderir WaitHandle ve diğerinde bekler, zaman aşımı aralığını olarak TimeSpan belirtir ve beklemeye girmeden önce bağlam için eşitleme etki alanından çıkılıp çıkılmayacağını belirtir.

public:
 static bool SignalAndWait(System::Threading::WaitHandle ^ toSignal, System::Threading::WaitHandle ^ toWaitOn, TimeSpan timeout, bool exitContext);

public static bool SignalAndWait(System.Threading.WaitHandle toSignal, System.Threading.WaitHandle toWaitOn, TimeSpan timeout, bool exitContext);

static member SignalAndWait : System.Threading.WaitHandle * System.Threading.WaitHandle * TimeSpan * bool -> bool

Public Shared Function SignalAndWait (toSignal As WaitHandle, toWaitOn As WaitHandle, timeout As TimeSpan, exitContext As Boolean) As Boolean

Parametreler

toSignal

WaitHandle

Sinyale WaitHandle .

toWaitOn

WaitHandle

WaitHandle Beklemek için.

timeout

TimeSpan

TimeSpan Bekleyebilecek aralığı temsil eden bir. Değer -1 ise, bekleme sonsuzdur.

exitContext

Boolean

true beklemeden önce bağlam için eşitleme etki alanından çıkmak (eşitlenmiş bir bağlamdaysa) ve daha sonra yeniden almak; aksi takdirde , false.

Döndürülenler

Boolean

true hem sinyal hem de bekleme başarıyla tamamlandıysa veya false sinyal tamamlandıysa ancak bekleme zaman aşımına uğradıysa.

Özel durumlar

ArgumentNullException

toSignal, null'e eşittir.

-veya-

toWaitOn, null'e eşittir.

NotSupportedException

yöntemi durumundaki bir iş parçacığında STA çağrıldı.

InvalidOperationException

toSignal bir semafordur ve zaten tam sayıya sahiptir.

ArgumentOutOfRangeException

timeout -1 dışında negatif bir milisaniye olarak değerlendirilir.

-veya-

timeout Int32.MaxValue değerinden büyüktür.

AbandonedMutexException

Bir iş parçacığı bir mutex serbest bırakmadan çıktığı için bekleme tamamlandı.

Açıklamalar

Bu işlemin atomik olması garanti değildir. Geçerli iş parçacığı sinyal verdikten toSignal sonra ancak üzerinde toWaitOnbeklemeden önce, başka bir işlemcide çalışan bir iş parçacığı sinyal toWaitOn verebilir veya üzerinde bekleyebilir.

için timeout en büyük değer: Int32.MaxValue.

Sıfır ise timeout , yöntemi engellemez. durumunu toWaitOn test eder ve hemen döndürür.

Bağlamdan çıkma

Bu exitContext yöntem, bilinmeyen bir yönetilen bağlamın içinden çağrılmadığı sürece parametresinin hiçbir etkisi yoktur. İş parçacığınız öğesinden ContextBoundObjecttüretilen bir sınıfın örneğine yönelik bir çağrının içindeyse yönetilen bağlam uyumsuz olabilir. şu anda gibi öğesinden ContextBoundObjectStringtüretilmemiş bir sınıfta bir yöntem yürütüyor olsanız bile, geçerli uygulama etki alanındaki yığınınızda bir varsaContextBoundObject, uyumsuz bir bağlamda olabilirsiniz.

Kodunuz bilinmeyen bir bağlamda yürütülürken, öğesinin true belirtilmesiexitContext, bu yöntemi yürütmeden önce iş parçacığının bilinmeyen yönetilen bağlamdan (yani varsayılan bağlama geçiş için) çıkmasına neden olur. İş parçacığı, bu yönteme yapılan çağrı tamamlandıktan sonra özgün bilinmeyen bağlama döner.

Bağlama bağlı sınıf özniteliğine sahip olduğunda bağlamdan SynchronizationAttribute çıkmak yararlı olabilir. Bu durumda, sınıfın üyelerine yapılan tüm çağrılar otomatik olarak eşitlenir ve eşitleme etki alanı sınıfın kod gövdesinin tamamıdır. Bir üyenin çağrı yığınındaki kod bu yöntemi çağırır ve için truebelirtirseexitContext, iş parçacığı eşitleme etki alanından çıkar ve nesnenin herhangi bir üyesine yapılan çağrıda engellenen bir iş parçacığının devam etmesini sağlar. Bu yöntem döndürdüğünde, çağrıyı yapan iş parçacığı eşitleme etki alanını yeniden eklemek için beklemelidir.