Message.Extension プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

メッセージに関連付けられているアプリケーション定義の追加情報を取得または設定します。

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[]

メッセージに関連付けられているアプリケーション定義の情報を提供するバイト値配列。既定値は長さ 0 の配列です。

メッセージキューがフィルター処理され、Extension プロパティを無視します。

Extension プロパティが null です。

プロパティは Extension 、メッセージに関連付けられたアプリケーション定義情報 (大きなバイナリオブジェクトなど) を提供します。プロパティの内容を解釈するのは、受信アプリケーションの Extension 責任です。

可能な場合は、プロパティではなくメッセージのプロパティに Body メッセージデータを Extension 含める必要があります。

外部キューを操作する場合は、プロパティを Extension 使用して、メッセージキューに存在しないメッセージプロパティを指定します。

外部キューは、Microsoft メッセージキュー以外のキューシステムに存在します。メッセージキューは、コネクタアプリケーションを介してこのようなキューと通信します。