WSHttpBinding

O exemplo wsHttp demonstra como implementar um serviço típico e um cliente típico usando o Windows Communication Foundation (WCF). Este exemplo consiste em um programa de console do cliente (client.exe) e uma biblioteca de serviços hospedada pelo IIS (Serviços de Informações da Internet). O serviço implementa um contrato que define um padrão de comunicação solicitação-resposta. O contrato é definido pela ICalculator interface, que expõe operações matemáticas (adicionar, subtrair, multiplicar e dividir). O cliente faz solicitações síncronas para uma determinada operação matemática e o serviço responde com o resultado. A atividade do cliente é visível na janela do console.

Nota

O procedimento de configuração e as instruções de compilação para este exemplo estão localizados no final deste tópico.

Este exemplo expõe o ICalculator contrato usando o <wsHttpBinding>. A configuração dessa ligação foi expandida no arquivo Web.config.

<bindings>
  <wsHttpBinding>
    <!--The following is the expanded configuration section for a-->
    <!--WSHttpBinding. Each property is configured with the default-->
    <!--value. See the ReliableSession, TransactionFlow, -->
    <!--TransportSecurity, and MessageSecurity samples in the WS -->
    <!--directory to learn how to configure these features. -->
    <binding name="Binding1"
              bypassProxyOnLocal="false"
              transactionFlow="false"
              hostNameComparisonMode="StrongWildcard"
              maxBufferPoolSize="524288"
              maxReceivedMessageSize="65536"
              messageEncoding="Text"
              textEncoding="utf-8"
              useDefaultWebProxy="true"
              allowCookies="false">
      <reliableSession ordered="true"
                       inactivityTimeout="00:10:00"
                       enabled="false" />
      <security mode="Message">
        <message clientCredentialType="Windows"
                 negotiateServiceCredential="true"
                 algorithmSuite="Default"
                 establishSecurityContext="true" />
      </security>
    </binding>
  </wsHttpBinding>
</bindings>

No elemento base binding , o maxReceivedMessageSize valor permite configurar o tamanho máximo de uma mensagem de entrada (em bytes). O hostNameComparisonMode valor permite configurar se o nome do host é considerado ao desmultiplexar mensagens para o serviço. O messageEncoding valor permite configurar se deseja usar a codificação Text ou MTOM para mensagens. O textEncoding valor permite configurar a codificação de caracteres para mensagens. O bypassProxyOnLocal valor permite configurar se deseja usar um proxy HTTP para comunicação local. O transactionFlow valor configura se a transação atual é fluída (se uma operação está configurada para fluxo de transação).

<No elemento reliableSession>, o valor Boolean ativado configura se as sessões confiáveis estão habilitadas. O ordered valor configura se a ordem das mensagens é preservada. O inactivityTimeout valor configura por quanto tempo uma sessão pode ficar ociosa antes de ser defeituosa.

<Na segurança>, o mode valor configura qual modo de segurança deve ser usado. Neste exemplo, a segurança de mensagens está sendo usada, e é por isso que a <mensagem> é especificada dentro da< segurança.>

Quando você executa o exemplo, as solicitações de operação e as respostas são exibidas na janela do console do cliente. Pressione ENTER na janela do cliente para desligar o cliente.

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

Para configurar, compilar e executar o exemplo

  1. Instale o ASP.NET 4.0 usando o seguinte comando.

    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable
    
  2. Certifique-se de ter executado o procedimento de instalação única para os exemplos do Windows Communication Foundation.

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

  4. Para executar o exemplo em uma configuração de máquina única ou cruzada, siga as instruções em Executando os exemplos do Windows Communication Foundation.