Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O conteúdo de 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 Windows Communication Foundation (WCF) usa o Contrato de Dados para converter um Message objeto 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 fio 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 pode ser realizada 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 Mensagens Personalizadas no Cliente
A IClientMessageFormatter interface define métodos que são usados para controlar a conversão de mensagens em objetos e objetos 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 despachada para a operação do cliente.
Em seguida, substitua o método SerializeRequest para serializar um objeto. Este método é chamado antes de enviar uma mensagem de saída.
Para inserir o formatador personalizado na aplicação de serviço, atribua o objeto IClientMessageFormatter à propriedade Formatter usando um comportamento de operação. Para obter informações sobre comportamentos, consulte Configurando e estendendo o tempo de execução com comportamentos.
Formatadores de Mensagens Personalizadas no Serviço
A interface IDispatchMessageFormatter define métodos que convertem o objeto Message em parâmetros para uma operação e de parâmetros no objeto Message em uma aplicação 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 despachada para a operação do cliente.
Em seguida, substitua o método SerializeRequest para serializar um objeto. Este método é chamado antes de enviar uma mensagem de saída.
Para inserir o formatador personalizado na aplicação de serviço, atribua o objeto IDispatchMessageFormatter à propriedade Formatter usando um comportamento de operação. Para obter informações sobre comportamentos, consulte Configurando e estendendo o tempo de execução com comportamentos.