MessageQueue.PeekByLookupId Metoda

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Wprowadzono w programie MSMQ 3.0. Przyjrzyj się określonej wiadomości z kolejki. Komunikat może być określony przez identyfikator odnośnika lub jego położenie na początku lub na końcu kolejki.

Przeciążenia

PeekByLookupId(Int64)	Wprowadzono w programie MSMQ 3.0. Przyjrzyj się komunikatowi, który jest zgodny z danym identyfikatorem odnośnika z kolejki innej niż transakcyjna.
PeekByLookupId(MessageLookupAction, Int64)	Wprowadzono w programie MSMQ 3.0. Przyjrzyj się określonej wiadomości z kolejki. Komunikat może być określony przez identyfikator odnośnika lub jego położenie na początku lub na końcu kolejki.

PeekByLookupId(Int64)

Wprowadzono w programie MSMQ 3.0. Przyjrzyj się komunikatowi, który jest zgodny z danym identyfikatorem odnośnika z kolejki innej niż transakcyjna.

public:
 System::Messaging::Message ^ PeekByLookupId(long lookupId);

public System.Messaging.Message PeekByLookupId (long lookupId);

member this.PeekByLookupId : int64 -> System.Messaging.Message

Public Function PeekByLookupId (lookupId As Long) As Message

Parametry

lookupId

Int64

Wiadomość LookupId , na która ma się pojawić.

Zwraca

Message

Właściwość, której LookupId właściwość jest zgodna Message z przekazanym parametremlookupId.

Wyjątki

PlatformNotSupportedException

Program MSMQ 3.0 nie jest zainstalowany.

InvalidOperationException

Nie można odnaleźć komunikatu z określonym lookupId .

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Uwagi

Użyj tej metody, aby odczytać komunikat ze znanym identyfikatorem odnośnika bez usunięcia go z kolejki. Ta metoda zgłasza wyjątek natychmiast, jeśli komunikat nie znajduje się w kolejce.

Właściwość LookupId komunikatu jest unikatowa dla kolejki, w której znajduje się komunikat, więc w kolejce będzie znajdować się co najwyżej jeden komunikat zgodny z danym lookupId parametrem.

Aby odczytać komunikat z określonym identyfikatorem odnośnika i usunąć go z kolejki, użyj ReceiveByLookupId metody .

W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej	Dostępne
Komputer lokalny	Tak
Komputer lokalny i nazwa formatu bezpośredniego	Tak
Komputer zdalny	Nie
Nazwa komputera zdalnego i formatu bezpośredniego	Tak

Zobacz też

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

Wprowadzono w programie MSMQ 3.0. Przyjrzyj się określonej wiadomości z kolejki. Komunikat może być określony przez identyfikator odnośnika lub jego położenie na początku lub na końcu kolejki.

public:
 System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);

public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);

member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.Message

Public Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Message

Parametry

action

MessageLookupAction

MessageLookupAction Jedną z wartości określających sposób odczytywania komunikatu w kolejce. Określ jedną z następujących opcji:

MessageLookupAction.Current: Zajrzyj do komunikatu określonego przez lookupId.

MessageLookupAction.Next: Przyjrzyj się komunikatowi po komunikacie określonym przez lookupId.

MessageLookupAction.Previous: Zajrzyj do komunikatu poprzedzającego komunikat określony przez lookupId.

MessageLookupAction.First: Przyjrzyj się pierwszej wiadomości w kolejce. Parametr lookupId musi być ustawiony na wartość 0.

MessageLookupAction.Last: Zajrzyj do ostatniego komunikatu w kolejce. Parametr lookupId musi być ustawiony na wartość 0.

lookupId

Int64

Wiadomość LookupId do zaglądowania lub 0. Wartość 0 jest używana podczas uzyskiwania dostępu do pierwszego lub ostatniego komunikatu w kolejce.

Zwraca

Message

Określony Message przez action parametry i lookupId przekazany.

Wyjątki

PlatformNotSupportedException

Program MSMQ 3.0 nie jest zainstalowany.

InvalidOperationException

Nie można odnaleźć komunikatu z określonym lookupId .

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

InvalidEnumArgumentException

Parametr action nie jest jednym z MessageLookupAction elementów członkowskich.

Uwagi

Użyj tej metody, aby odczytać komunikat ze znanym identyfikatorem odnośnika bez usunięcia go z kolejki. Ta metoda zgłasza wyjątek natychmiast, jeśli komunikat nie znajduje się w kolejce.

Właściwość LookupId komunikatu jest unikatowa dla kolejki, w której znajduje się komunikat, więc w kolejce będzie znajdować się co najwyżej jeden komunikat zgodny z danym lookupId parametrem.

Aby odczytać komunikat o określonym identyfikatorze i usunąć go z kolejki, użyj ReceiveByLookupId metody .

W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej	Dostępne
Komputer lokalny	Tak
Komputer lokalny i nazwa formatu bezpośredniego	Tak
Komputer zdalny	Nie
Nazwa komputera zdalnego i formatu bezpośredniego	Tak

Zobacz też

• LookupId
• ReceiveByLookupId