WaitHandle.SignalAndWait Yöntem

Başvuru

Tanım

Ad Alanı:: System.Threading

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Birini işaret eder WaitHandle ve diğerini bekler.

Aşırı Yüklemeler

SignalAndWait(WaitHandle, WaitHandle)	Birini işaret eder WaitHandle ve diğerini bekler.
SignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)	Bir WaitHandle sinyal gönderir ve diğerinde bekler, zaman aşımı aralığını 32 bit imzalı 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 WaitHandle sinyal gönderir 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

Kaynak:: WaitHandle.cs

Kaynak:: WaitHandle.cs

Birini işaret eder WaitHandle 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 Beklenmek için.

Döndürülenler

Boolean

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

Özel durumlar

ArgumentNullException

toSignal, null değeridir.

-veya-

toWaitOn, null değeridir.

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 vermesine ve ardından iş parçacığının görevi bitirmesini beklemesine izin vermek için yöntemi 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 EventResetMode.ManualReset oluşturulan öğesini EventWaitHandle kullanarak bunların tümünü serbest bırakır.

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

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.

Şunlara uygulanır

SignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)

Kaynak:: WaitHandle.cs

Kaynak:: WaitHandle.cs

Kaynak:: WaitHandle.cs

Bir WaitHandle sinyal gönderir ve diğerinde bekler, zaman aşımı aralığını 32 bit imzalı 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 Beklenmek için.

millisecondsTimeout: Int32

Bekleyebilecek aralığı temsil eden bir tamsayı. Değer ise Infinite, yani -1, 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 değeridir.

-veya-

toWaitOn, null değeridir.

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, sonsuz bir zaman aşımını temsil eden negatif bir sayıdır.

AbandonedMutexException

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

Açıklamalar

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

Bağlamdan çıkma

Bu exitContext yöntem, bilinmeyen yönetilen bağlamın içinden çağrılmadığı sürece parametresinin hiçbir etkisi olmaz. İş 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ğlamda hiçbir zaman uyumsuz olabilir. şu anda gibi Stringöğesinden ContextBoundObjecttüretilmiş olmayan 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, varsayılan olmayan bir bağlamda olabilirsiniz.

Kodunuz bilinmeyen bir bağlamda yürütülürken öğesinin belirtilmesi trueexitContext , iş parçacığının bu yöntemi yürütmeden önce bilinmeyen yönetilen bağlamdan (varsayılan bağlama geçiş için) çıkmasını sağlar. İş parçacığı, bu yöntem çağrısı 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 öğesini exitContextbelirtirsetrue, iş parçacığı eşitleme etki alanından çıkar ve bu da 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ığının eşitleme etki alanını yeniden eklemek için beklemesi gerekir.

Şunlara uygulanır

SignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)

Kaynak:: WaitHandle.cs

Kaynak:: WaitHandle.cs

Kaynak:: WaitHandle.cs

Bir WaitHandle sinyal gönderir 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 Beklenmek için.

timeout: TimeSpan

TimeSpan Bekleyebilecek aralığı temsil eden bir. Değer -1 ise bekleme süresi 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 değeridir.

-veya-

toWaitOn, null değeridir.

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-

timeoutInt32.MaxValue değerinden büyüktür.

AbandonedMutexException

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

Açıklamalar

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

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

Bağlamdan çıkma

Şunlara uygulanır

WaitHandle.SignalAndWait Yöntem

Tanım

Aşırı Yüklemeler

SignalAndWait(WaitHandle, WaitHandle)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

SignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Bağlamdan çıkma

Şunlara uygulanır

SignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Bağlamdan çıkma

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar