Message.Extension Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает дополнительные, определяемые приложением сведения, связанные с данным сообщением.
public:
property cli::array <System::Byte> ^ Extension { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
[System.Messaging.MessagingDescription("MsgExtension")]
public byte[] Extension { get; set; }
[<System.Messaging.MessagingDescription("MsgExtension")>]
member this.Extension : byte[] with get, set
Public Property Extension As Byte()
Значение свойства
- Byte[]
Массив байтовых значений, предоставляющий дополнительные, определяемые приложением, сведения, связанные с данным сообщением. По умолчанию задан массив нулевой длины.
- Атрибуты
Исключения
Очередь сообщений фильтруется, чтобы не учитывать свойство Extension.
Значение свойства Extension — null
.
Комментарии
Свойство Extension предоставляет сведения, определенные приложением, например большой двоичный объект, связанный с сообщением. Принимающее приложение обязано интерпретировать содержимое Extension свойства.
По возможности следует включать данные сообщений в Body свойство сообщения, а не Extension свойство.
При работе с иностранными очередями используйте Extension свойство, чтобы указать свойства сообщения, которые не существуют в очереди сообщений.
Внешняя очередь существует в системе очередей, отличной от очереди сообщений Майкрософт. Очередь сообщений взаимодействует с такими очередями через приложение соединителя.