NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Message.Extension

Gets or sets additional information associated with the message.

[Visual Basic]
Overridable Public Property Extension As Byte ()
[C#]
public byte[] Extension {virtual get; virtual set;}
[C++]
public: __property virtual unsigned char* get_Extension();
public: __property virtual void set_Extension(unsigned char*[]);
[JScript]
public function get Extension() : Byte[];
public function set Extension(Byte[]);

Property Value

An array of 8-bit unsigned integers that provides additional, application-defined information associated with the message. The default is a zero-length array of 8-bit unsigned integers.

Exceptions

Exception Type Condition
InvalidOperationException The message queue is not filtered to read the Extension property.
ArgumentException The Extension is a null reference (in Visual Basic Nothing).

Remarks

Extension provides access to the Extension property of the Message Queuing MSMQMessage object.

Where possible, message data should be included in the body of the message rather than in the extension. Use Extension rather than AppSpecific when you must attach a random binary large object. You must code the application to interpret the content of this array.

Example

See Also

Message Class | Message Members | System.Messaging Namespace | Body | AppSpecific