Udostępnij za pośrednictwem


MessageQueue.PeekByLookupId Metoda

Definicja

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

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

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

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

Dotyczy