XmlMessageFormatter.TargetTypeNames Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa zestaw możliwych typów, które będą deserializowane przez formatator z podanego 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, setPublic Property TargetTypeNames As String()Wartość właściwości
Tablica typu String określająca typy obiektów do deserializacji z treści komunikatu podczas odczytywania komunikatu.
- Atrybuty
Wyjątki
Właściwość TargetTypeNames jest null.
Uwagi
TargetTypeNames Obie właściwości i TargetTypes informują formater, 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 przy użyciu Receive metody metoda tworzy obiekt typu odpowiadającego zidentyfikowanym 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 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 numer wersji musi być również dołączany do nazwy typu docelowego.
Typy docelowe są wymagane tylko podczas odczytywania z kolejki. Właściwości TargetTypeNames i TargetTypes nie muszą być ustawione do zapisu w kolejce.
