XmlMessageFormatter.TargetTypeNames Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie l’ensemble des types possibles qui seront désérialisés par le formateur à partir du message fourni.
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()Valeur de propriété
Tableau de type String qui spécifie les types d’objets à désérialiser à partir du corps du message lors de la lecture du message.
- Attributs
Exceptions
La TargetTypeNames propriété est null.
Remarques
Les propriétés et TargetTypeNames les TargetTypes propriétés indiquent au formateur quels schémas tenter de faire correspondre lors de la désérialisation d’un message. Cela permet au formateur d’interpréter le corps du message.
L’instance sérialisée dans le corps du message doit se conformer à l’un des schémas représentés dans le tableau de types. Lorsque vous lisez le message à l’aide de la Receive méthode, la méthode crée un objet du type qui correspond au schéma identifié et lit le corps du message dans celui-ci.
Une seule des deux propriétés doit être définie lors de la lecture à partir de la file d’attente, mais vous pouvez définir les deux. L’ensemble de types est le jeu combiné à partir des deux propriétés. La décision de la propriété à utiliser est spécifique à votre application. Si le corps du message contient un type dont le schéma ne correspond à aucun des types du tableau pour l’une ou l’autre propriété, une exception est levée lorsque le message est lu.
TargetTypeNames nécessite que chaque entrée soit complète, en spécifiant son nom d’assembly. En outre, lors de l’utilisation de plusieurs versions simultanées, le numéro de version doit également être ajouté au nom du type cible.
Les types cibles sont uniquement requis lors de la lecture à partir de la file d’attente. Les TargetTypeNames propriétés et TargetTypes les propriétés n’ont pas besoin d’être définies pour écrire dans la file d’attente.
