Codificação e transporte de associação personalizado

O exemplo de Transporte demonstra como configurar uma associação personalizada com vários elementos de codificação de mensagens e transporte. Uma associação personalizada é definida por uma lista ordenada de elementos de associação discretos.

Este exemplo é baseado no Self-Host e foi modificado para configurar três pontos de extremidade para dar suporte a transportes HTTP, TCP e NamedPipe com associações personalizadas. A configuração do cliente foi modificada da mesma forma e o código do cliente foi alterado para se comunicar com cada um dos três pontos de extremidade.

O exemplo demonstra como configurar uma associação personalizada que dá suporte a um transporte específico e codificação de mensagens. Isso é feito configurando um transporte e uma codificação de mensagem para o elemento binding. A ordenação de elementos de associação é importante na definição de uma associação personalizada, pois cada uma representa uma camada na pilha de canais (consulte Associações personalizadas). Este exemplo configura três associações personalizadas: um transporte HTTP com codificação de texto, um transporte TCP com codificação de texto e um transporte NamedPipe com codificação binária.

A configuração do serviço define as associações personalizadas da seguinte maneira:

<bindings>
    <customBinding>
        <binding name="HttpBinding" >
            <textMessageEncoding
                messageVersion="Soap12Addressing10"/>
            <httpTransport />
        </binding>
        <binding name="TcpBinding" >
            <textMessageEncoding />
            <tcpTransport />
        </binding>
        <binding name="NamedPipeBinding" >
            <binaryMessageEncoding />
            <namedPipeTransport />
        </binding>
    </customBinding>
</bindings>

Quando você executa a amostra, as solicitações de operação e as respostas são exibidas no serviço e na janela do console do cliente. O cliente se comunica com cada um dos três pontos de extremidade, acessando primeiro HTTP, depois TCP e, finalmente, NamedPipe. Pressione ENTER em cada janela do console para desligar o serviço e o cliente.

A associação namedPipeTransport não dá suporte a operações de computador para computador. Ela é usada apenas para comunicação no mesmo computador. Portanto, ao executar o exemplo em um cenário entre máquinas, comente as seguintes linhas no arquivo de código do cliente:

CalculatorClient client = new CalculatorClient("default");
Console.WriteLine("Communicate with named pipe endpoint.");
// Call operations.
DoCalculations(client);
//Closing the client gracefully closes the connection and cleans up resources
client.Close();

Dim client As New CalculatorClient("default")
Console.WriteLine("Communicate with named pipe endpoint.")
' call operations
DoCalculations(client)
'Closing the client gracefully closes the connection and cleans up resources
client.Close()

Para configurar, compilar, e executar o exemplo

1. Verifique se você executou o Procedimento de instalação única para os exemplos do Windows Communication Foundation.

2. Para compilar a edição C#, C++ ou Visual Basic .NET da solução, siga as instruções em Como compilar os exemplos do Windows Communication Foundation.

3. Para executar o exemplo em uma configuração de computador único ou cruzado, siga as instruções em Como executar os exemplos do Windows Communication Foundation.