XmlMessageFormatter.TargetTypeNames Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Określa zestaw możliwych typów, które zostaną zdeserializowane przez program formatujący z dostarczonego komunikatu.

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()

Wartość właściwości

String[]

Tablica typu String określająca typy obiektów do deserializacji z treści komunikatu podczas odczytywania komunikatu.

Atrybuty
MessagingDescriptionAttribute

Wyjątki

ArgumentNullException

Właściwość TargetTypeNames to null.

Uwagi

TargetTypeNames Obie właściwości i TargetTypes informują program formatujący, jakie schematy mają być zgodne podczas deserializacji komunikatu. Dzięki temu program formatujący może interpretować treść komunikatu.

Wystąpienie serializowane w treści komunikatu musi być zgodne z jednym ze schematów reprezentowanych w tablicy typów. Podczas odczytywania komunikatu Receive przy użyciu metody metoda tworzy obiekt typu, który odpowiada zidentyfikowanemu schematowi i odczytuje do niego treść komunikatu.

Podczas odczytywania z kolejki należy ustawić tylko jedną z dwóch właściwości, ale można ustawić obie te właściwości. Zestaw typów jest zestawem połączonym z dwóch właściwości. Decyzja o tym, która właściwość ma być używana, jest specyficzna dla twojej aplikacji. Jeśli treść komunikatu zawiera typ, którego schemat nie pasuje do żadnego z typów w tablicy dla dowolnej właściwości, podczas odczytywania komunikatu zostanie zgłoszony wyjątek.

TargetTypeNames wymaga, aby każdy wpis był w pełni kwalifikowany, określając jego nazwę zestawu. Ponadto podczas pracy z wieloma współbieżnymi wersjami należy również dołączyć numer wersji do nazwy typu docelowego.

Typy docelowe są wymagane tylko podczas odczytywania z kolejki. Właściwości TargetTypeNames i TargetTypes nie muszą być ustawione tak, aby zapisywały dane w kolejce.

Dotyczy

Zobacz też