MessagePropertyFilter.Extension Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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

Boolean

true, wenn Informationen über den Extension abgerufen werden, andernfalls false. Der Standardwert ist false.

Attribute

MessagingDescriptionAttribute

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.

Weitere Informationen

• Extension
• DefaultExtensionSize
• MessageQueue