Custom Message Formatters
O conteúdo em uma mensagem geralmente está na forma de XML, que geralmente não é um formato conveniente para um aplicativo. Os aplicativos manipulam objetos, obtendo e definindo suas propriedades. O WCF (Windows Communication Foundation) usa o contrato de dados para converter um objeto Message em um objeto facilmente manipulado por um aplicativo. Esses processos são chamados de serialização e desserialização. Observe que esses mesmos termos são usados para descrever a serialização e a desserialização feitas pela camada de transporte de e para o formato de transmissão de mensagem, que é um processo não relacionado.
Você pode usar um formatador de mensagens personalizado se precisar implementar uma conversão especializada entre mensagens e objetos que não consiga realizar por meio de um contrato de dados. Faça isso modificando ou estendendo o comportamento de execução de uma operação de contrato específica em um cliente ou serviço.
Formatadores de mensagem personalizados no cliente
A interface IClientMessageFormatter define métodos que são usados para controlar a conversão de mensagens em objetos e em mensagens para aplicativos cliente.
Você deve implementar essa interface. Primeiro, substitua o método DeserializeReply para desserializar uma mensagem. Esse método é chamado depois que uma mensagem de entrada é recebida, mas antes de ser enviada para a operação do cliente.
Em seguida, substitua o método SerializeRequest para serializar um objeto. Esse método é chamado antes de enviar uma mensagem de saída.
Para inserir o formatador personalizado no aplicativo de serviço, atribua o objeto IClientMessageFormatter à propriedade Formatter usando um comportamento de operação. Para obter informações sobre comportamentos, consulte Configurar e estender o runtime com comportamentos.
Formatadores de mensagem personalizados no serviço
A interface IDispatchMessageFormatter define métodos que convertem um objeto Message em parâmetros para uma operação e de parâmetros em um objeto Message em um aplicativo de serviço.
Você deve implementar essa interface. Primeiro, substitua o método DeserializeReply para desserializar uma mensagem. Esse método é chamado depois que uma mensagem de entrada é recebida, mas antes de ser enviada para a operação do cliente.
Em seguida, substitua o método SerializeRequest para serializar um objeto. Esse método é chamado antes de enviar uma mensagem de saída.
Para inserir o formatador personalizado no aplicativo de serviço, atribua o objeto IDispatchMessageFormatter à propriedade Formatter usando um comportamento de operação. Para obter informações sobre comportamentos, consulte Configurar e estender o runtime com comportamentos.