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
Instale o ASP.NET 4.0 usando o seguinte comando.
%windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable
Certifique-se de ter executado o procedimento de instalação única para os exemplos do Windows Communication Foundation.
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.
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.