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átovacím nástrojem z poskytnuté 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 Vlastnosti i TargetTypes sdělují formátovacímu modulu, jaká schémata se má při deserializaci zprávy pokusit shodovat. To umožňuje formátovacímu nástroji interpretovat text zprávy.
Instance serializovaná v textu zprávy musí být v souladu s jedním ze schémat reprezentovaných v poli typů. Při čtení zprávy pomocí Receive metody metoda vytvoří 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 jenom jednu z těchto dvou vlastností, ale můžete nastavit obě vlastnosti. Sada typů je kombinovaná sada ze dvou vlastností. Rozhodnutí o tom, 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 z vlastností, vyvolá se při čtení zprávy výjimka.
TargetTypeNames vyžaduje, aby každá položka byla plně kvalifikovaná a zadala název sestavení. Při práci s více souběžnými verzemi musí být navíc číslo verze připojeno také k názvu cílového typu.
Cílové typy se vyžadují pouze při čtení z fronty. Vlastnosti TargetTypeNames a TargetTypes nemusí být nastaveny pro zápis do fronty.