MessagePropertyFilter.DefaultExtensionSize Property
Definition
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
The default extension buffer size to create when the message is received. The default is 255 bytes.
- Attributes
Exceptions
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.