WaitHandle.WaitAll Method (WaitHandle(), Int32)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Waits for all the elements in the specified array to receive a signal, using an Int32 value to specify the time interval.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Shared Function WaitAll ( _ waitHandles As WaitHandle(), _ millisecondsTimeout As Integer _ ) As Boolean
Parameters
- waitHandles
- Type:
System.Threading.WaitHandle
()
An array that contains the objects for which the current instance will wait. This array cannot contain multiple references to the same object.
- millisecondsTimeout
- Type: System.Int32
The number of milliseconds to wait, or Timeout.Infinite (-1) to wait indefinitely.
Return Value
Type: System.Booleantrue when every element in waitHandles has received a signal; otherwise, false.
| Exception | Condition |
|---|---|
| ArgumentNullException | The waitHandles parameter is Nothing. -or- One or more of the objects in the waitHandles array is Nothing. |
| ArgumentException | The waitHandles array contains elements that are duplicates. -or- waitHandles is an array with no elements. |
| NotSupportedException | The number of objects in waitHandles is greater than the system permits. |
| ArgumentOutOfRangeException | millisecondsTimeout is a negative number other than -1, which represents an infinite time-out. |
If millisecondsTimeout is zero, the method does not block. It tests the state of the wait handles and returns immediately.
The WaitAll method returns when the wait terminates, either when all the handles are signaled or when a time-out occurs. On some implementations, if more than 64 handles are passed, a NotSupportedException is thrown. If there are duplicates in the array, the call fails with an ArgumentException.
If you call this method from a single-threaded apartment, and waitHandles contains more than one wait handle, the method deadlocks.
Version Notes
Windows Phone
WaitAll is present but not supported in Windows Phone.The following example shows how to use this overload of the WaitAll method to report progress while waiting for multiple threads to finish. Each time the WaitAll method times out, the thread that was waiting reports progress to the user interface thread.
This code is part of a larger example provided for the WaitHandle class.