Como: Hospedar um serviço WCF no IIS

Artigo
03/05/2024

Este tópico descreve as etapas básicas necessárias para criar um serviço WCF (Windows Communication Foundation) hospedado no IIS (Serviços de Informações da Internet). Este tópico pressupõe que você esteja familiarizado com o IIS e entenda como usar a ferramenta de gerenciamento do IIS para criar e gerenciar aplicativos do IIS. Para obter mais informações sobre o IIS, consulte Serviços de Informações da Internet. Um serviço WCF executado no ambiente do IIS aproveita ao máximo os recursos do IIS, como reciclagem de processos, desligamento ocioso, monitoramento da integridade do processo e ativação baseada em mensagens. Essa opção de hospedagem requer que o IIS esteja configurado corretamente, mas não requer que qualquer código de hospedagem seja escrito como parte do aplicativo. Você pode usar a hospedagem do IIS somente com um transporte HTTP.

Para obter mais informações sobre como o WCF e o ASP.NET interagem, consulte WCF Services and ASP.NET. Para obter mais informações sobre como configurar a segurança, consulte Segurança.

Para obter a cópia de origem deste exemplo, consulte IIS Hosting Using Inline Code.

Para criar um serviço hospedado pelo IIS

Confirme se o IIS está instalado e em execução no seu computador. Para obter mais informações sobre como instalar e configurar o IIS, consulte Instalando e configurando o IIS 7.0
Crie uma nova pasta para seus arquivos de aplicativo chamada "IISHostedCalcService", verifique se ASP.NET tem acesso ao conteúdo da pasta e use a ferramenta de gerenciamento do IIS para criar um novo aplicativo IIS que esteja fisicamente localizado nesse diretório de aplicativo. Ao criar um alias para o diretório do aplicativo, use "IISHostedCalc".
Crie um novo arquivo chamado "service.svc" no diretório do aplicativo. Edite este arquivo adicionando o seguinte @ServiceHost elemento.
```
<%@ServiceHost language=c# Debug="true" Service="Microsoft.ServiceModel.Samples.CalculatorService"%>
```
Crie um subdiretório App_Code dentro do diretório do aplicativo.
Crie um arquivo de código chamado Service.cs no subdiretório App_Code.
Adicione as seguintes using diretivas à parte superior do arquivo Service.cs.
```
using System;
using System.ServiceModel;
```
Adicione a seguinte declaração de namespace após as using diretivas.
```
namespace Microsoft.ServiceModel.Samples
{
}
```

Defina o contrato de serviço dentro da declaração de namespace, conforme mostrado no código a seguir.

[ServiceContract]
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);
}

<ServiceContract()> _
Public Interface ICalculator

    <OperationContract()> _
    Function Add(ByVal n1 As Double, _
                   ByVal n2 As Double) As Double

    <OperationContract()> _
    Function Subtract(ByVal n1 As Double, _
                      ByVal n2 As Double) As Double

    <OperationContract()> _
    Function Multiply(ByVal n1 As Double, _
                      ByVal n2 As Double) As Double

    <OperationContract()> _
    Function Divide(ByVal n1 As Double, _
                    ByVal n2 As Double) As Double
End Interface

Implemente o contrato de serviço após a definição do contrato de serviço, conforme mostrado no código a seguir.

public class CalculatorService : ICalculator
{
   public double Add(double n1, double n2)
   {
      return n1 + n2;
   }
   public double Subtract(double n1, double n2)
   {
      return n1 - n2;
   }
   public double Multiply(double n1, double n2)
   {
      return n1 * n2;
   }
   public double Divide(double n1, double n2)
   {
      return n1 / n2;
   }
}

Public Class CalculatorService
    Implements ICalculator
    Public Function Add(ByVal n1 As Double, _
                        ByVal n2 As Double) As Double Implements ICalculator.Add
        Return n1 + n2
    End Function

    Public Function Subtract(ByVal n1 As Double, _
                             ByVal n2 As Double) As Double Implements ICalculator.Subtract
        Return n1 - n2
    End Function

    Public Function Multiply(ByVal n1 As Double, _
                             ByVal n2 As Double) As Double Implements ICalculator.Multiply
        Return n1 * n2
    End Function

    Public Function Divide(ByVal n1 As Double, _
                           ByVal n2 As Double) As Double Implements ICalculator.Divide
        Return n1 / n2
    End Function
End Class

Crie um arquivo chamado "Web.config" no diretório do aplicativo e adicione o seguinte código de configuração ao arquivo. Em tempo de execução, a infraestrutura WCF usa as informações para construir um ponto de extremidade com o qual os aplicativos cliente podem se comunicar.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService" behaviorConfiguration="CalculatorServiceBehaviors">

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

        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>

    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehaviors">
          <!-- Add the following element to your service behavior configuration. -->
          <serviceMetadata httpGetEnabled="true" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>

</configuration>

Este exemplo especifica explicitamente os pontos de extremidade no arquivo de configuração. Se você não adicionar nenhum ponto de extremidade ao serviço, o tempo de execução adicionará pontos de extremidade padrão para você. Para obter mais informações sobre pontos de extremidade padrão, associações e comportamentos, consulte Configuração simplificada e configuração simplificada para serviços WCF.

Para se certificar de que o serviço está alojado corretamente, abra um navegador e navegue até ao URL do serviço: http://localhost/IISHostedCalc/Service.svc

Exemplo

A seguir está uma lista completa do código para o serviço de calculadora hospedado no IIS.

using System;
using System.ServiceModel;

namespace Microsoft.ServiceModel.Samples
{

  [ServiceContract]
  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);
  }


  public class CalculatorService : ICalculator
  {
     public double Add(double n1, double n2)
     {
        return n1 + n2;
     }
     public double Subtract(double n1, double n2)
     {
        return n1 - n2;
     }
     public double Multiply(double n1, double n2)
     {
        return n1 * n2;
     }
     public double Divide(double n1, double n2)
     {
        return n1 / n2;
     }
  }
}


Imports System.ServiceModel

Namespace Microsoft.ServiceModel.Samples

    <ServiceContract()> _
    Public Interface ICalculator

        <OperationContract()> _
        Function Add(ByVal n1 As Double, _
                       ByVal n2 As Double) As Double

        <OperationContract()> _
        Function Subtract(ByVal n1 As Double, _
                          ByVal n2 As Double) As Double

        <OperationContract()> _
        Function Multiply(ByVal n1 As Double, _
                          ByVal n2 As Double) As Double

        <OperationContract()> _
        Function Divide(ByVal n1 As Double, _
                        ByVal n2 As Double) As Double
    End Interface


    Public Class CalculatorService
        Implements ICalculator
        Public Function Add(ByVal n1 As Double, _
                            ByVal n2 As Double) As Double Implements ICalculator.Add
            Return n1 + n2
        End Function

        Public Function Subtract(ByVal n1 As Double, _
                                 ByVal n2 As Double) As Double Implements ICalculator.Subtract
            Return n1 - n2
        End Function

        Public Function Multiply(ByVal n1 As Double, _
                                 ByVal n2 As Double) As Double Implements ICalculator.Multiply
            Return n1 * n2
        End Function

        Public Function Divide(ByVal n1 As Double, _
                               ByVal n2 As Double) As Double Implements ICalculator.Divide
            Return n1 / n2
        End Function
    End Class

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService" behaviorConfiguration="CalculatorServiceBehaviors">

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

        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>

    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehaviors">
          <!-- Add the following element to your service behavior configuration. -->
          <serviceMetadata httpGetEnabled="true" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>

</configuration>

Partilhar via

Como: Hospedar um serviço WCF no IIS

Para criar um serviço hospedado pelo IIS

Exemplo

Consulte também

Recursos adicionais