Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le contenu d’un message est souvent au format XML, ce qui n’est généralement pas un format pratique pour une application. Les applications manipulent des objets, obtiennent et définissent leurs propriétés. Windows Communication Foundation (WCF) utilise le contrat de données pour convertir un Message objet en objet facilement géré par une application. Ces processus sont appelés sérialisation et désérialisation. Notez que ces mêmes termes sont utilisés pour décrire la sérialisation et la désérialisation effectuées par la couche de transport vers et depuis le format de fil de message, qui est un processus non lié.
Vous pouvez utiliser un formateur de message personnalisé si vous devez implémenter une conversion spécialisée entre les messages et les objets que vous ne pouvez pas accomplir par le biais d’un contrat de données. Pour ce faire, modifiez ou étendez le comportement d’exécution d’une opération de contrat spécifique sur un client ou un service.
Formateurs de messages personnalisés sur le client
L’interface IClientMessageFormatter définit les méthodes utilisées pour contrôler la conversion de messages en objets et objets en messages pour les applications clientes.
Vous devez implémenter cette interface. Commencez par remplacer la DeserializeReply méthode pour désérialiser un message. Cette méthode est appelée après la réception d’un message entrant, mais avant sa distribution à l’opération cliente.
Ensuite, remplacez la SerializeRequest méthode pour sérialiser un objet. Cette méthode est appelée avant d’envoyer un message sortant.
Pour insérer le formateur personnalisé dans l’application de service, affectez l’objet IClientMessageFormatter à la propriété Formatter à l'aide d’un comportement d’opération. Pour plus d’informations sur les comportements, consultez Configuration et extension du runtime avec des comportements.
Formateurs de messages personnalisés sur le service
L’interface IDispatchMessageFormatter définit des méthodes qui convertissent un Message objet en paramètres pour une opération et à partir de paramètres en objet Message dans une application de service.
Vous devez implémenter cette interface. Commencez par remplacer la DeserializeReply méthode pour désérialiser un message. Cette méthode est appelée après la réception d’un message entrant, mais avant sa distribution à l’opération cliente.
Ensuite, remplacez la SerializeRequest méthode pour sérialiser un objet. Cette méthode est appelée avant d’envoyer un message sortant.
Pour insérer le formateur personnalisé dans l’application de service, affectez l’objet IDispatchMessageFormatter à la propriété Formatter à l'aide d’un comportement d’opération. Pour plus d’informations sur les comportements, consultez Configuration et extension du runtime avec des comportements.