Message.LookupId Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Messaging
Assembly:
System.Messaging.dll

Introdotto in MSMQ 3.0. Ottiene l'identificatore di ricerca del messaggio.

public:
 property long LookupId { long get(); };
public long LookupId { get; }
member this.LookupId : int64
Public ReadOnly Property LookupId As Long

Valore della proprietà

Int64

Identificatore di ricerca del messaggio, generato da Accodamento messaggi e univoco nella coda in cui si trova il messaggio.

Eccezioni

PlatformNotSupportedException

MSMQ 3.0 non è installato.

InvalidOperationException

Il messaggio non è stato inviato. Questa proprietà può essere letta solamente da messaggi recuperati da una coda.

-oppure-

La coda di messaggi viene filtrata in modo che venga ignorata la proprietà LookupId.

Commenti

La LookupId proprietà fornisce l'accesso in sola lettura all'identificatore di ricerca di un messaggio. L'identificatore di ricerca, introdotto in MSMQ 3.0, è un identificatore a 64 bit generato dall'accodamento messaggi e assegnato a ogni messaggio quando il messaggio viene inserito nella coda. L'identificatore di ricerca non è uguale all'identificatore del messaggio generato quando viene inviato il messaggio.

Accodamento messaggi genera un identificatore di ricerca per tutti i messaggi inseriti in qualsiasi coda, inclusa la destinazione generata dall'applicazione, l'amministrazione e le code di report, nonché il journal generato dal sistema, la lettera non recapitata, il connettore e le code in uscita. In altre parole, questo include entrambi i messaggi inviati tramite l'invio di applicazioni e l'accodamento messaggi. L'identificatore di ricerca è univoco per la coda e non ha alcun significato all'esterno della coda.

Se un messaggio viene inviato a diverse code di destinazione o se una copia di un messaggio viene archiviata in un journal di computer o in un journal di coda, ogni copia del messaggio avrà un identificatore di ricerca personalizzato quando viene inserito nella rispettiva coda.

La LookupId proprietà può essere letta solo sui messaggi recuperati da una coda.

Viene usato un identificatore di ricerca per leggere un messaggio specifico nella coda. Dopo che l'identificatore di ricerca di un messaggio è noto, l'applicazione ricevente può chiamare l'applicazione PeekByLookupId o ReceiveByLookupId per passare direttamente a tale messaggio e a recuperarla dalla coda, a differenza dei cursori che devono iniziare all'inizio della coda e spostarsi verso la fine della coda,

Ottenere gli identificatori di ricerca dei messaggi nella coda è la responsabilità dell'applicazione. Un modo possibile per ottenere gli identificatori di ricerca consiste nel creare un trigger per la coda di destinazione che richiama un componente che memorizza nella cache gli identificatori di ogni messaggio quando vengono inseriti nella coda.

Si applica a

Vedi anche