XmlMessageFormatter.TargetTypeNames Propriété

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

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, set
Public Property TargetTypeNames As String()

Valeur de propriété

String[]

Tableau de type String qui spécifie les types d'objets à désérialiser à partir du corps du message lors de sa lecture.

Attributs
MessagingDescriptionAttribute

Exceptions

ArgumentNullException

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.

S’applique à

Voir aussi