XmlMessageFormatter.TargetTypeNames Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje sadu možných typů, které budou deserializovány formátovačem ze zadané zprávy.
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()
Hodnota vlastnosti
Pole typu String , které určuje typy objektů, které se mají deserializovat z textu zprávy při čtení zprávy.
- Atributy
Výjimky
Vlastnost TargetTypeNames je null.
Poznámky
TargetTypeNames Formátovací modul i TargetTypes vlastnosti říkají, jaká schémata se mají při deserializaci zprávy shodovat. Díky tomu může formátovací modul interpretovat text zprávy.
Instance serializovaná v textu zprávy musí splňovat jedno ze schémat reprezentovaných v poli typů. Při čtení zprávy pomocí Receive metody vytvoří metoda objekt typu, který odpovídá identifikovanému schématu a přečte do něj text zprávy.
Při čtení z fronty je potřeba nastavit pouze jednu ze dvou vlastností, ale obojí můžete nastavit. Sada typů je kombinovaná sada ze dvou vlastností. Rozhodnutí, kterou vlastnost použít, je specifická pro vaši aplikaci. Pokud text zprávy obsahuje typ, jehož schéma neodpovídá žádnému z typů v poli pro některou vlastnost, bude vyvolán výjimka při čtení zprávy.
TargetTypeNames vyžaduje, aby byla každá položka plně kvalifikovaná a zadala její název sestavení. Navíc při práci s více souběžnými verzemi musí být číslo verze také připojeno k názvu cílového typu.
Cílové typy jsou vyžadovány pouze při čtení z fronty. Vlastnosti TargetTypeNames a TargetTypes vlastnosti nemusí být nastaveny na zápis do fronty.