MessagePropertyFilter.Extension Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob beim Einsehen oder beim Empfang einer Meldung die Extension-Eigenschaft abgerufen wird, oder legt diesen fest.
public:
property bool Extension { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MsgExtension")]
public bool Extension { get; set; }
[<System.Messaging.MessagingDescription("MsgExtension")>]
member this.Extension : bool with get, set
Public Property Extension As Boolean
Eigenschaftswert
true
, wenn Informationen über den Extension abgerufen werden, andernfalls false
. Der Standardwert ist false
.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Verwendung des Extension-Attributs veranschaulicht.
// Set the queue's MessageReadPropertyFilter property
// to enable the message's Extension property.
queue->MessageReadPropertyFilter->Extension = true;
// Peek at the message. Time out after ten seconds
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));
// Display the value of the message's Extension property.
Console::WriteLine("Message.Extension: {0}",
orderMessage->Extension);
// Set the queue's MessageReadPropertyFilter property to enable the
// message's Extension property.
queue.MessageReadPropertyFilter.Extension = true;
// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));
// Display the value of the message's Extension property.
Console.WriteLine("Message.Extension: {0}",
orderMessage.Extension);
Hinweise
Die Extension -Eigenschaft der Message -Klasse stellt zusätzliche anwendungsdefinierte Informationen bereit, die der Nachricht zugeordnet sind, z. B. ein großes binäres Objekt. Es liegt in der Verantwortung der empfangenden Anwendung, den Inhalt des Extensionzu interpretieren.