Procedure: Een WCF-service hosten in IIS

In dit onderwerp vindt u een overzicht van de basisstappen die nodig zijn voor het maken van een WCF-service (Windows Communication Foundation) die wordt gehost in Internet Information Services (IIS). In dit onderwerp wordt ervan uitgegaan dat u bekend bent met IIS en begrijpt hoe u het IIS-beheerprogramma gebruikt om IIS-toepassingen te maken en te beheren. Zie Internet Information Services voor meer informatie over IIS. Een WCF-service die wordt uitgevoerd in de IIS-omgeving, maakt optimaal gebruik van IIS-functies, zoals procesrecycling, niet-actieve afsluiting, processtatuscontrole en activering op basis van berichten. Deze hostingoptie vereist dat IIS correct is geconfigureerd, maar vereist niet dat er hostingcode wordt geschreven als onderdeel van de toepassing. U kunt IIS-hosting alleen gebruiken met een HTTP-transport.

Zie WCF-services en ASP.NET voor meer informatie over de interactie tussen WCF en ASP.NET. Zie Beveiliging voor meer informatie over het configureren van beveiliging.

Zie IIS-hosting met behulp van inlinecode voor de bronkopie van dit voorbeeld.

Een service maken die wordt gehost door IIS

1. Controleer of IIS is geïnstalleerd en wordt uitgevoerd op uw computer. Zie IIS 7.0 installeren en configurerenvoor meer informatie over het installeren en configureren van IIS.

2. Maak een nieuwe map voor uw toepassingsbestanden met de naam IISHostedCalcService, zorg ervoor dat ASP.NET toegang heeft tot de inhoud van de map en gebruik het HULPPROGRAMMA IIS-beheer om een nieuwe IIS-toepassing te maken die zich fysiek in deze toepassingsmap bevindt. Wanneer u een alias voor de toepassingsmap maakt, gebruikt u IISHostedCalc.

3. Maak een nieuw bestand met de naam service.svc in de toepassingsmap. Bewerk dit bestand door het volgende @ServiceHost element toe te voegen.

   <%@ServiceHost language=c# Debug="true" Service="Microsoft.ServiceModel.Samples.CalculatorService"%>
   

4. Maak een App_Code submap in de toepassingsmap.

5. Maak een codebestand met de naam Service.cs in de submap App_Code.

6. Voeg de volgende using instructies toe aan het begin van het Service.cs-bestand.

   using System;
   using System.ServiceModel;
   

7. Voeg de volgende naamruimtedeclaratie toe na de using instructies.

   namespace Microsoft.ServiceModel.Samples
   {
   }
   

8. Definieer het servicecontract in de naamruimtedeclaratie, zoals wordt weergegeven in de volgende code.

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

9. Implementeer het servicecontract na de definitie van het servicecontract, zoals wordt weergegeven in de volgende code.

   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;
      }
   }
   

10. Maak een bestand met de naam Web.config in de toepassingsmap en voeg de volgende configuratiecode toe aan het bestand. Tijdens runtime gebruikt de WCF-infrastructuur de informatie om een eindpunt te maken waarmee clienttoepassingen kunnen communiceren.

    <?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>
    

    In dit voorbeeld worden expliciet eindpunten in het configuratiebestand opgegeven. Als u geen eindpunten aan de service toevoegt, voegt de runtime standaardeindpunten voor u toe. Zie Vereenvoudigde configuratie en vereenvoudigde configuratie voor WCF-services voor meer informatie over standaardeindpunten, bindingen en gedrag.

11. Als u wilt controleren of de service correct wordt gehost, opent u een browser en bladert u naar de URL van de service: http://localhost/IISHostedCalc/Service.svc

Opmerking

Hier volgt een volledige lijst van de code voor de door IIS gehoste rekenmachineservice.

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;
     }
  }
}

<?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>

Zie ook

• Hosting in Internet Information Services
• Hostingservices
• WCF-services en -ASP.NET
• Beveiliging
• Hostingfuncties voor Windows Server App Fabric