MessagePropertyFilter.DefaultExtensionSize Property

Reference

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the size, in bytes, of the default extension buffer.

public:
 property int DefaultExtensionSize { int get(); void set(int value); };

[System.Messaging.MessagingDescription("MsgDefaultExtensionSize")]
public int DefaultExtensionSize { get; set; }

[<System.Messaging.MessagingDescription("MsgDefaultExtensionSize")>]
member this.DefaultExtensionSize : int with get, set

Public Property DefaultExtensionSize As Integer

Property Value

Int32

The default extension buffer size to create when the message is received. The default is 255 bytes.

Attributes: MessagingDescriptionAttribute

Exceptions

ArgumentException

The assigned value is negative.

Examples

The following code example demonstrates the use of the DefaultExtensionSize property.

// Set the filter's DefaultExtensionSize
// property to 1024 bytes.
queue->MessageReadPropertyFilter->
    DefaultExtensionSize = 1024;

// Display the new value of the filter's 
// DefaultExtensionSize property.
Console::WriteLine(
    "MessageReadPropertyFilter."
    "DefaultExtensionSize: {0}", 
    queue->MessageReadPropertyFilter->
    DefaultExtensionSize);

// Set the filter's DefaultExtensionSize property to 1024 bytes.
queue.MessageReadPropertyFilter.DefaultExtensionSize = 1024;

// Display the new value of the filter's DefaultExtensionSize property.
Console.WriteLine("MessageReadPropertyFilter.DefaultExtensionSize: {0}",
    queue.MessageReadPropertyFilter.DefaultExtensionSize.ToString());

Remarks

The default extension size specifies the number of bytes to allocate for the message's extension. The Extension property of the Message class represents the additional, application-defined information associated with the message, such as a binary large object. It is the responsibility of the application to interpret the contents of the Extension.

Applies to