MessageQueue::GetEnumerator Method ()
.NET Framework (current version)
Note: This API is now obsolete.
Namespace:
System.Messaging
Assembly: System.Messaging (in System.Messaging.dll)
Return to top
Enumerates the messages in a queue. GetEnumerator is deprecated. GetMessageEnumerator2 should be used instead.
Assembly: System.Messaging (in System.Messaging.dll)
public: [ObsoleteAttribute("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")] virtual IEnumerator^ GetEnumerator() sealed
Return Value
Type: System.Collections::IEnumerator^A IEnumerator that provides a dynamic connection to the messages in the queue.
Implements
IEnumerable::GetEnumerator()The following table shows whether this method is available in various Workgroup modes.
Workgroup mode | Available |
|---|---|
Local computer | Yes |
Local computer and direct format name | Yes |
Remote computer | No |
Remote computer and direct format name | Yes |
The following code example demonstrates the use of GetEnumerator.
// Connect to a queue on the local computer. MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue"); // Get an IEnumerator object. System::Collections::IEnumerator^ enumerator = queue->GetMessageEnumerator2(); // Use the IEnumerator object to loop through the messages. while(enumerator->MoveNext()) { // Get a message from the enumerator. Message^ msg = (Message^)enumerator->Current; // Display the label of the message. Console::WriteLine(msg->Label); } queue->Close();
.NET Framework
Available since 1.1
Available since 1.1
Show: