Extension Property (Message)

Gets or sets additional, application-defined information associated with the message.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Hidden)>
<ReadOnlyAttribute(True)>
<MessagingDescriptionAttribute("Provides a place to put additional application-defined information that is associated with the message.")>
Public Property Extension As Byte()

'Usage
 
Dim instance As Message
Dim value() As Byte
 
instance.Extension = value
 
value = instance.Extension

[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[ReadOnly(true)]
[MessagingDescription("Provides a place to put additional application-defined information that is associated with the message.")]
public byte[] Extension {get; set;}

[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[ReadOnly(true)]
[MessagingDescription("Provides a place to put additional application-defined information that is associated with the message.")]
public:
property array<byte>^ Extension {
   array<byte>^ get();
   void set (    array<byte>^ value);
}

Property Value

An array of byte values that provides application-defined information associated with the message. The default is a zero-length array.

Exceptions

Exception	Description
System.InvalidOperationException	The message queue is filtered to ignore the Extension property.
System.ArgumentException	The Extension property is null.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Message Class
Message Members