MessageQueue.GetMessageEnumerator 메서드

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator();

public System.Messaging.MessageEnumerator GetMessageEnumerator();

[System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")]
public System.Messaging.MessageEnumerator GetMessageEnumerator();

member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

[<System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")>]
member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator () As MessageEnumerator

반품

MessageEnumerator 큐에 포함된 메시지를 보관하는 경우

특성

ObsoleteAttribute

설명

GetMessageEnumerator 는 큐에 있는 모든 메시지의 동적 목록을 만듭니다. 해당 반환을 호출 RemoveCurrentMessageEnumeratorGetMessageEnumerator 하여 열거자의 현재 위치에 있는 메시지를 큐에서 제거할 수 있습니다.

커서는 큐의 동적 메시지 목록과 연결되므로 메시지가 현재 커서 위치를 벗어나는 경우 열거형은 큐의 메시지를 수정한 내용을 반영합니다. 예를 들어 열거자는 커서의 현재 위치보다 우선 순위가 낮은 메시지에 자동으로 액세스할 수 있지만 해당 위치 앞에 삽입된 우선 순위가 높은 메시지는 액세스할 수 없습니다. 그러나 열거형을 다시 설정하여 커서를 목록의 시작 부분으로 다시 이동하려면 .를 호출 ResetMessageEnumerator합니다.

열거형의 메시지 순서는 큐의 순서를 반영하므로 우선 순위가 낮은 메시지보다 우선 순위가 높은 메시지가 표시됩니다.

메시지에 대한 동적 연결이 아닌 큐에 있는 메시지의 정적 스냅샷을 원하는 경우 호출 GetAllMessages합니다. 이 메서드는 메서드가 호출되었을 때의 Message 메시지를 나타내는 개체 배열을 반환합니다.

다음 표에서는 이 메서드를 다양한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.

추가 정보

• GetAllMessages()
• GetMessageEnumerator2()
• GetMessageQueueEnumerator()