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 le jeu de types éventuels qui sont 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 sa lecture.
- Attributs
Exceptions
La propriété TargetTypeNames a la valeur null.
Remarques
TargetTypeNames Les propriétés et TargetTypes indiquent au formateur les schémas à essayer de faire correspondre lors de la désérialisation d’un message. Cela permet au formateur d’interpréter le corps du message.
Le instance sérialisé dans le corps du message doit être conforme à 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 l’ensemble combiné 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 exige que chaque entrée soit complète, en spécifiant son nom d’assembly. En outre, lorsque vous utilisez 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 n’ont pas besoin d’être définies pour écrire dans la file d’attente.
