Message.LookupId Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geïntroduceerd in MSMQ 3.0. Hiermee haalt u de opzoek-id van het bericht op.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongWaarde van eigenschap
De opzoek-id van het bericht, die wordt gegenereerd door Message Queuing en uniek is voor de wachtrij waarin het bericht zich bevindt.
Uitzonderingen
MSMQ 3.0 is niet geïnstalleerd.
Het bericht is niet verzonden. Deze eigenschap kan alleen worden gelezen op berichten die zijn opgehaald uit een wachtrij.
– of –
De berichtenwachtrij wordt gefilterd om de LookupId eigenschap te negeren.
Opmerkingen
De LookupId eigenschap biedt alleen-lezentoegang tot de opzoek-id van een bericht. De opzoek-id, geïntroduceerd in MSMQ 3.0, is een 64-bits id die wordt gegenereerd door Message Queuing en wordt toegewezen aan elk bericht wanneer het bericht in de wachtrij wordt geplaatst. De opzoek-id is niet hetzelfde als de bericht-id die wordt gegenereerd wanneer het bericht wordt verzonden.
Message Queuing genereert een opzoek-id voor alle berichten die in een wachtrij worden geplaatst, waaronder door toepassingen gegenereerde doel-, beheer- en rapportwachtrijen, evenals door het systeem gegenereerd logboek, dead-letter, connector en uitgaande wachtrijen. Met andere woorden, dit omvat zowel berichten die worden verzonden door toepassingen te verzenden als door Message Queuing. De opzoek-id is uniek voor de wachtrij en heeft geen betekenis buiten de wachtrij.
Als een bericht naar verschillende doelwachtrijen wordt verzonden of als een kopie van een bericht is opgeslagen in een computerlogboek of wachtrijlogboek, heeft elke kopie van het bericht een eigen opzoek-id wanneer het in de respectieve wachtrij wordt geplaatst.
De LookupId eigenschap kan alleen worden gelezen op berichten die zijn opgehaald uit een wachtrij.
Er wordt een opzoek-id gebruikt om een specifiek bericht in de wachtrij te lezen. Zodra de opzoek-id van een bericht bekend is, kan de ontvangende toepassing de PeekByLookupId of ReceiveByLookupId functie aanroepen om rechtstreeks naar dat bericht te gaan en deze te bekijken of op te halen uit de wachtrij, in tegenstelling tot cursors die aan de voorkant van de wachtrij moeten beginnen en naar het einde van de wachtrij moeten navigeren,
Het verkrijgen van de opzoek-id's van de berichten in de wachtrij is de verantwoordelijkheid van de toepassing. Een mogelijke manier om de opzoek-id's te verkrijgen, is door een trigger te maken voor de doelwachtrij die een onderdeel aanroept waarmee de id's van elk bericht worden opgeslagen terwijl ze in de wachtrij worden geplaatst.