Cliente ASMX com um serviço WCF

O exemplo ASMX demonstra como criar um serviço usando o Windows Communication Foundation (WCF) e, em seguida, acessar o serviço de um cliente não-WCF, como um cliente ASMX.

Este exemplo consiste em um programa de console do cliente (.exe) e uma biblioteca de serviços (.dll) 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 (Add, Subtract, Multiply, e Divide). O cliente ASMX faz solicitações síncronas para uma operação matemática e o serviço responde com o resultado.

O serviço implementa um ICalculator contrato conforme definido no código a seguir.

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"), XmlSerializerFormat]
public interface ICalculator
{
    [OperationContract]
    double Add(double n1, double n2);
    [OperationContract]
    double Subtract(double n1, double n2);
    [OperationContract]
    double Multiply(double n1, double n2);
    [OperationContract]
    double Divide(double n1, double n2);
}

O DataContractSerializer e o XmlSerializer mapeiam tipos CLR para uma representação XML. O DataContractSerializer interpreta algumas representações XML de forma diferente de XmlSerializer. Geradores de proxy não-WCF, como Wsdl.exe, geram uma interface mais utilizável quando o XmlSerializer está sendo usado. O XmlSerializerFormatAttribute é aplicado à ICalculator interface, para garantir que o XmlSerializer seja usado para mapear tipos CLR para XML. A implementação do serviço calcula e retorna o resultado apropriado.

O serviço expõe um único endpoint para comunicação com o serviço, definido por meio de um arquivo de configuração (Web.config). O endpoint consiste em um endereço, uma ligação e um contrato. O serviço expõe o endpoint no endereço base que é fornecido pelo host dos Serviços de Informação da Internet (IIS). O binding atributo é definido como basicHttpBinding que fornece comunicações HTTP usando SOAP 1.1, que é compatível com WS-I BasicProfile 1.1, conforme mostrado na configuração de exemplo a seguir.

<services>
  <service name="Microsoft.ServiceModel.Samples.CalculatorService"
           behaviorConfiguration="CalculatorServiceBehavior">
    <!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc.  -->
    <endpoint address=""
              binding="basicHttpBinding"
              contract="Microsoft.ServiceModel.Samples.ICalculator" />
  </service>
</services>

O cliente ASMX se comunica com o serviço WCF usando um proxy digitado que é gerado pelo utilitário WSDL (Web Services Description Language) (Wsdl.exe). O proxy digitado está contido no arquivo generatedClient.cs. O utilitário WSDL recupera metadados para o serviço especificado e gera um proxy tipado para uso por um cliente para se comunicar. Por padrão, a estrutura não expõe nenhum metadados. Para expor os metadados necessários para gerar o proxy, você deve adicionar um <serviceMetadata> e definir seu httpGetEnabled atributo como True mostrado na configuração a seguir.

<behaviors>
  <serviceBehaviors>
    <behavior name="CalculatorServiceBehavior">
      <!-- Setting httpGetEnabled to True on the serviceMetadata
           behavior exposes the service's wsdl at <base address>?wsdl :
           http://localhost/servicemodelsamples/service.svc?wsdl -->
      <serviceMetadata httpGetEnabled="True"/>
      <serviceDebug includeExceptionDetailInFaults="False" />
    </behavior>
  </serviceBehaviors>
</behaviors>

Execute o seguinte comando a partir de um prompt de comando no diretório do cliente para gerar o proxy digitado.

wsdl /n:Microsoft.ServiceModel.Samples /o:generatedClient.cs /urlkey:CalculatorServiceAddress http://localhost/servicemodelsamples/service.svc?wsdl

Ao utilizar o proxy tipado gerado, o cliente pode aceder a um endpoint de serviço configurando o endereço apropriado. O cliente usa um arquivo de configuração (App.config) para especificar o ponto de extremidade com o qual se comunicar.

<appSettings>
  <add key="CalculatorServiceAddress"
       value="http://localhost/ServiceModelSamples/service.svc"/>
</appSettings>

A implementação do cliente constrói uma instância do proxy digitado para começar a se comunicar com o serviço.

// Create a client to the CalculatorService.
using (CalculatorService client = new CalculatorService())
{
    // Call the Add service operation.
    double value1 = 100.00D;
    double value2 = 15.99D;
    double result = client.Add(value1, value2);
    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

    // Call the Subtract service operation.
    value1 = 145.00D;
    value2 = 76.54D;
    result = client.Subtract(value1, value2);
    Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

    // Call the Multiply service operation.
    value1 = 9.00D;
    value2 = 81.25D;
    result = client.Multiply(value1, value2);
    Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

    // Call the Divide service operation.
    value1 = 22.00D;
    value2 = 7.00D;
    result = client.Divide(value1, value2);
    Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

}

Console.WriteLine();
Console.WriteLine("Press <ENTER> to terminate client.");
Console.ReadLine();

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. Verifique se você executou o procedimento de instalação do One-Time para os exemplos do Windows Communication Foundation.

2. 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.

3. 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.