XmlMessageFormatter.TargetTypeNames プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
提供されたメッセージからフォーマッタで逆シリアル化できる型のセットを指定します。
public:
property cli::array <System::String ^> ^ TargetTypeNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };[System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")]
public string[] TargetTypeNames { get; set; }[<System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")>]
member this.TargetTypeNames : string[] with get, setPublic Property TargetTypeNames As String()プロパティ値
- String[]
メッセージの読み取り時に、メッセージ本文から逆シリアル化されるオブジェクトの型を指定する String 型の配列。
- 属性
例外
TargetTypeNames プロパティが null です。
注釈
プロパティとTargetTypes両方とも、TargetTypeNamesメッセージを逆シリアル化するときに照合を試みるスキーマをフォーマッタに伝えます。 これにより、フォーマッタはメッセージ本文を解釈できます。
メッセージ本文でシリアル化されるインスタンスは、型配列で表されるスキーマのいずれかに準拠している必要があります。 メソッドを使用して Receive メッセージを読み取ると、メソッドによって、識別されたスキーマに対応する型のオブジェクトが作成され、メッセージ本文が読み取られます。
キューからの読み取り時に設定する必要があるのは 2 つのプロパティのうちの 1 つだけですが、両方を設定できます。 型のセットは、2 つのプロパティの組み合わせセットです。 使用するプロパティの決定は、アプリケーションに固有です。 メッセージ本文に、いずれかのプロパティの配列内のどの型にもスキーマが一致しない型が含まれている場合、メッセージの読み取り時に例外がスローされます。
TargetTypeNames では、アセンブリ名を指定して、すべてのエントリを完全修飾する必要があります。 また、複数の同時実行バージョンを使用する場合は、ターゲットの種類名にもバージョン番号を追加する必要があります。
ターゲットの種類は、キューからの読み取り時にのみ必要です。 TargetTypeNamesキューに書き込むには、プロパティとTargetTypesプロパティを設定する必要はありません。