MessageQueue.PeekByLookupId Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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. Zapoznaj się z komunikatem zgodnym 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. Zapoznaj się z komunikatem zgodnym 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.MessagePublic Function PeekByLookupId (lookupId As Long) As MessageParametry
Zwraca
Właściwość, której LookupId właściwość jest zgodna Message z przekazanym parametremlookupId.
Wyjątki
Program MSMQ 3.0 nie jest zainstalowany.
Nie można odnaleźć komunikatu z określonym lookupId .
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 usuwania 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ż
Dotyczy
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.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParametry
- 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
Określony Message przez action parametry i lookupId przekazany.
Wyjątki
Program MSMQ 3.0 nie jest zainstalowany.
Nie można odnaleźć komunikatu z określonym lookupId .
Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.
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 usuwania 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 |