Condividi tramite


MessageQueue.PeekByLookupId Metodo

Definizione

Introdotto in MSMQ 3.0. Legge un messaggio specifico nella coda. Il messaggio può essere specificato da un identificatore di ricerca o in base alla relativa posizione all'inizio o alla fine della coda.

Overload

PeekByLookupId(Int64)

Introdotto in MSMQ 3.0. Legge il messaggio che corrisponde all'identificatore di ricerca specificato da una coda non transazionale.

PeekByLookupId(MessageLookupAction, Int64)

Introdotto in MSMQ 3.0. Legge un messaggio specifico nella coda. Il messaggio può essere specificato da un identificatore di ricerca o in base alla relativa posizione all'inizio o alla fine della coda.

PeekByLookupId(Int64)

Introdotto in MSMQ 3.0. Legge il messaggio che corrisponde all'identificatore di ricerca specificato da una coda non transazionale.

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

Parametri

lookupId
Int64

Proprietà LookupId del messaggio da leggere.

Restituisce

Oggetto Message la cui proprietà LookupId corrisponde al parametro lookupId passato.

Eccezioni

MSMQ 3.0 non è installato.

Impossibile trovare il messaggio con il parametro lookupId specificato.

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Commenti

Usare questo metodo per leggere un messaggio con un identificatore di ricerca noto senza rimuoverlo dalla coda. Questo metodo genera un'eccezione immediatamente se il messaggio non è nella coda.

La LookupId proprietà di un messaggio è univoca alla coda in cui risiede il messaggio, quindi sarà presente al massimo un messaggio nella coda che corrisponde al parametro specificato lookupId .

Per leggere un messaggio con un identificatore di ricerca specificato e rimuoverlo dalla coda, usare il ReceiveByLookupId metodo .

La tabella seguente mostra se questo metodo è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro Disponibile
Computer locale
Nome del computer locale e del formato diretto
Computer remoto No
Nome del formato diretto e del computer remoto

Vedi anche

Si applica a

PeekByLookupId(MessageLookupAction, Int64)

Introdotto in MSMQ 3.0. Legge un messaggio specifico nella coda. Il messaggio può essere specificato da un identificatore di ricerca o in base alla relativa posizione all'inizio o alla fine della coda.

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

Parametri

action
MessageLookupAction

Uno dei valori di MessageLookupAction, che specifica come deve essere letto il messaggio nella coda. Specificare uno dei valori seguenti:

MessageLookupAction.Current: legge il messaggio specificato da lookupId.

MessageLookupAction.Next: legge il messaggio che segue il messaggio specificato da lookupId.

MessageLookupAction.Previous: legge il messaggio che precede il messaggio specificato da lookupId.

MessageLookupAction.First: legge il primo messaggio della coda. Il parametro lookupId deve essere impostato su 0.

MessageLookupAction.Last: legge l'ultimo messaggio della coda. Il parametro lookupId deve essere impostato su 0.

lookupId
Int64

Proprietà LookupId del messaggio da leggere oppure 0. 0 viene utilizzato quando si accede al primo o all'ultimo messaggio della coda.

Restituisce

Oggetto Message specificato dai parametri action e lookupId passati.

Eccezioni

MSMQ 3.0 non è installato.

Impossibile trovare il messaggio con il parametro lookupId specificato.

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Il parametro action non è uno dei membri di MessageLookupAction.

Commenti

Usare questo metodo per leggere un messaggio con un identificatore di ricerca noto senza rimuoverlo dalla coda. Questo metodo genera un'eccezione immediatamente se il messaggio non è nella coda.

La LookupId proprietà di un messaggio è univoca alla coda in cui risiede il messaggio, quindi sarà presente al massimo un messaggio nella coda che corrisponde al parametro specificato lookupId .

Per leggere un messaggio con un identificatore specificato e rimuoverlo dalla coda, usare il ReceiveByLookupId metodo .

La tabella seguente mostra se questo metodo è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro Disponibile
Computer locale
Nome del computer locale e del formato diretto
Computer remoto No
Nome del formato diretto e del computer remoto

Vedi anche

Si applica a