MessageQueue.GetMessageEnumerator Metoda

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Upozornění

This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.

Vytvoří objekt enumerátoru pro všechny zprávy ve frontě. GetMessageEnumerator() je zastaralý. GetMessageEnumerator2() by měl být použit místo toho.

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();

[<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

Návraty

MessageEnumerator

Uchovávání MessageEnumerator zpráv obsažených ve frontě.

Atributy

ObsoleteAttribute

Poznámky

GetMessageEnumerator vytvoří dynamický seznam všech zpráv ve frontě. Zprávu z fronty můžete odebrat na aktuální pozici enumerátoru voláním RemoveCurrent této MessageEnumeratorGetMessageEnumerator zprávy.

Vzhledem k tomu, že kurzor je přidružený k dynamickému seznamu zpráv ve frontě, bude výčet odrážet všechny změny provedené ve zprávách ve frontě, pokud je zpráva mimo aktuální pozici kurzoru. Enumerátor může například automaticky přistupovat ke zprávě s nižší prioritou umístěnou mimo aktuální pozici kurzoru, ale ne zprávu s vyšší prioritou vloženou před danou pozici. Můžete však obnovit výčet, čímž přesunete kurzor zpět na začátek seznamu voláním ResetMessageEnumeratorpro .

Pořadí zpráv ve výčtu odráží jejich pořadí ve frontě, takže zprávy s vyšší prioritou se zobrazí před zprávami s nižší prioritou.

Pokud chcete statický snímek zpráv ve frontě místo dynamického připojení k nim, zavolejte GetAllMessages. Tato metoda vrátí pole Message objektů, které představují zprávy v době, kdy byla volána metoda.

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	Available
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	Yes
Název vzdáleného počítače a přímého formátu	Yes

Viz také

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