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。

備註

TargetTypeNames和 TargetTypes 屬性都會告訴格式器在還原串行化訊息時要嘗試比對的架構。 這可讓格式器解譯訊息本文。

在訊息本文中串行化的實例必須符合類型陣列中所表示的其中一個架構。 當您使用 Receive 方法讀取訊息時，方法會建立型別的物件，該對象對應至所識別的架構，並將訊息本文讀入其中。

從佇列讀取時，只需要設定兩個屬性的其中一個，但您可以設定這兩個屬性。 類型集合是來自兩個屬性的合併集。 要使用哪一個屬性的決策專屬於您的應用程式。 如果訊息本文包含的型別，其架構不符合任一屬性之陣列中的任何類型，則會在讀取訊息時擲回例外狀況。

TargetTypeNames 要求每個專案都必須完整，並指定其元件名稱。 此外，使用多個並行版本時，也必須將版本號碼附加至目標類型名稱。

只有在從佇列讀取時，才需要目標類型。 TargetTypeNames和 TargetTypes 屬性不需要設定為寫入佇列。

適用於

另請參閱