MessageQueue.PeekByLookupId Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.MessagePublic Function PeekByLookupId (lookupId As Long) As MessageParametri
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 | Sì |
| Nome del computer locale e del formato diretto | Sì |
| Computer remoto | No |
| Nome del formato diretto e del computer remoto | Sì |
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.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParametri
- 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 | Sì |
| Nome del computer locale e del formato diretto | Sì |
| Computer remoto | No |
| Nome del formato diretto e del computer remoto | Sì |
