Message.LookupId Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Introducerades i MSMQ 3.0. Hämtar meddelandets uppslagsidentifierare.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongEgenskapsvärde
Meddelandets uppslagsidentifierare, som genereras av Message Queuing och är unik för kön där meddelandet finns.
Undantag
MSMQ 3.0 är inte installerat.
Meddelandet har inte skickats. Den här egenskapen kan bara läsas på meddelanden som hämtats från en kö.
-eller-
Meddelandekön filtreras för att ignorera egenskapen LookupId .
Kommentarer
Egenskapen LookupId ger skrivskyddad åtkomst till ett meddelandes uppslagsidentifierare. Uppslagsidentifieraren, som introducerades i MSMQ 3.0, är en 64-bitars identifierare som genereras av Message Queuing och tilldelas till varje meddelande när meddelandet placeras i kön. Uppslagsidentifieraren är inte samma som meddelandeidentifieraren som genereras när meddelandet skickas.
Message Queuing genererar en uppslagsidentifierare för alla meddelanden som placeras i valfri kö, inklusive programgenererade mål-, administrations- och rapportköer, samt systemgenererade journaler, obeställbara meddelanden, anslutningsappar och utgående köer. Detta omfattar med andra ord både meddelanden som skickas genom att skicka program och av Message Queuing. Uppslagsidentifieraren är unik för kön och har ingen betydelse utanför kön.
Om ett meddelande skickas till flera målköer, eller om en kopia av ett meddelande lagras i en datorjournal eller köjournal, har varje kopia av meddelandet sin egen uppslagsidentifierare när den placeras i sin respektive kö.
Egenskapen LookupId kan bara läsas på meddelanden som hämtats från en kö.
En uppslagsidentifierare används för att läsa ett specifikt meddelande i kön. När uppslagsidentifieraren för ett meddelande är känd kan det mottagande programmet anropa PeekByLookupId funktionen eller ReceiveByLookupId för att gå direkt till meddelandet och titta på eller hämta det från kön, till skillnad från markörer som måste börja längst fram i kön och navigera mot slutet av kön.
Det är programmets ansvar att hämta uppslagsidentifierarna för meddelandena i kön. Ett möjligt sätt att hämta uppslagsidentifierarna är att skapa en utlösare för målkön som anropar en komponent som cachelagrar identifierarna för varje meddelande när de placeras i kön.
