XmlMessageFormatter.TargetTypeNames プロパティ

  • リファレンス

定義

名前空間:
System.Messaging
アセンブリ:
System.Messaging.dll

提供されたメッセージからフォーマッタで逆シリアル化できる型のセットを指定します。

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, set
Public Property TargetTypeNames As String()

プロパティ値

String[]

メッセージの読み取り時に、メッセージ本文から逆シリアル化されるオブジェクトの型を指定する String 型の配列。

属性
MessagingDescriptionAttribute

例外

ArgumentNullException

TargetTypeNames プロパティが null です。

注釈

プロパティと TargetTypes プロパティのTargetTypeNames両方で、メッセージを逆シリアル化するときに照合を試みるスキーマがフォーマッタに通知されます。 これにより、フォーマッタはメッセージ本文を解釈できます。

メッセージ本文でシリアル化されたインスタンスは、型配列で表されるスキーマのいずれかに準拠している必要があります。 メソッドを使用して Receive メッセージを読み取ると、 メソッドによって、識別されたスキーマに対応する型のオブジェクトが作成され、メッセージ本文が読み取られます。

キューからの読み取り時に設定する必要があるのは 2 つのプロパティのうちの 1 つだけですが、両方を設定できます。 型のセットは、2 つのプロパティの組み合わせセットです。 使用するプロパティの決定は、アプリケーションに固有です。 メッセージ本文に、いずれかのプロパティの配列内のどの型にもスキーマが一致しない型が含まれている場合、メッセージの読み取り時に例外がスローされます。

TargetTypeNames では、アセンブリ名を指定して、すべてのエントリを完全修飾する必要があります。 さらに、複数の同時実行バージョンを操作する場合は、ターゲットの型名にもバージョン番号を追加する必要があります。

ターゲットの種類は、キューから読み取る場合にのみ必要です。 および TargetTypes プロパティはTargetTypeNames、キューに書き込むのに設定する必要はありません。

適用対象

こちらもご覧ください