Export (0) Print
Expand All

ConcurrentQueue(Of T).TryDequeue Method

Tries to remove and return the object at the beginning of the concurrent queue.

Namespace:  System.Collections.Concurrent
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
Public Function TryDequeue ( _
	<OutAttribute> ByRef result As T _
) As Boolean

Parameters

result
Type: T

When this method returns, if the operation was successful, result contains the object removed. If no object was available to be removed, the value is unspecified.

Return Value

Type: System.Boolean
true if an element was removed and returned from the beginning of the ConcurrentQueue(Of T) successfully; otherwise, false.

ConcurrentQueue(Of T) handles all synchronization internally. If two threads call TryDequeue at precisely the same moment, neither operation is blocked. When a conflict is detected between two threads, one thread has to try again to retrieve the next element, and the synchronization is handled internally.

TryDequeue tries to remove an element from the queue. If the method is successful, the item is removed and the method returns true; otherwise, it returns false. That happens atomically with respect to other operations on the queue. If the queue was populated with code such as q.Enqueue("a"); q.Enqueue("b"); q.Enqueue("c"); and two threads concurrently try to dequeue an element, one thread will dequeue a and the other thread will dequeue b. Both calls to TryDequeue will return true, because they were both able to dequeue an element. If each thread goes back to dequeue an additional element, one of the threads will dequeue c and return true, whereas the other thread will find the queue empty and will return false.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1

Windows Phone 8.1, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft