Sdílet prostřednictvím

XmlMessageFormatter.TargetTypeNames Vlastnost

  • Reference

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

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

String[]

Pole typu String , které určuje typy objektů, které se mají deserializovat z textu zprávy při čtení zprávy.

Atributy
MessagingDescriptionAttribute

Výjimky

ArgumentNullException

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.

Platí pro

Viz také