方法: IIS で WCF サービスをホストする

[アーティクル]
04/03/2023

ここでは、インターネットインフォメーションサービス (IIS) でホストされる Windows Communication Foundation (WCF) サービスを作成するために必要な基本手順について説明します。このトピックは、IIS に関する知識があり、IIS 管理ツールを使用して IIS アプリケーションを作成および管理する方法を理解していることを前提としています。 IIS の詳細については、インターネットインフォメーションサービスに関するページを参照してください。 IIS 環境で実行される WCF サービスでは、プロセスリサイクル、アイドルシャットダウン、処理状況の監視、メッセージベースのアクティブ化などの IIS 機能が最大限に利用されます。このホストオプションでは、IIS が正しく構成されている必要がありますが、アプリケーションの一部としてホストコードを書く必要はありません。 IIS ホストは、HTTP トランスポートでのみ使用できます。

WCF と ASP.NET の相互作用の詳細については、「WCF サービスと ASP.NET」を参照してください。セキュリティの構成の詳細については、セキュリティに関するページを参照してください。

この例のソースコピーについては、「インラインコードを使用した IIS ホスティング」を参照してください。

IIS でホストされるサービスを作成するには

コンピューターに IIS がインストールされ、実行されていることを確認します。 IIS のインストールと構成の詳細については、IIS 7.0 のインストールと構成に関するページを参照してください。
アプリケーションファイル用に "IISHostedCalcService" という新しいフォルダーを作成し、ASP.NET がそのフォルダーの内容にアクセスできることを確認します。次に、IIS 管理ツールを使用して、このアプリケーションディレクトリに物理的に配置する新しい IIS アプリケーションを作成します。アプリケーションディレクトリのエイリアスを作成する場合は、"IISHostedCalc" を使用します。
"service.svc" という新しいファイルをアプリケーションディレクトリに作成します。次の @ServiceHost 要素を追加して、このファイルを編集します。
```
<%@ServiceHost language=c# Debug="true" Service="Microsoft.ServiceModel.Samples.CalculatorService"%>
```
アプリケーションディレクトリ内に App_Code サブディレクトリを作成します。
App_Code サブディレクトリに Service.cs というコードファイルを作成します。
Service.cs ファイルの先頭に次の using ステートメントを追加します。
```
using System;  
using System.ServiceModel;  
```
using ステートメントの後に、次の名前空間宣言を追加します。
```
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);
}

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

アプリケーションディレクトリ内に "Web.config" というファイルを作成し、次の構成コードをファイルに追加します。実行時に WCF インフラストラクチャは、その情報を使用して、クライアントアプリケーションが通信できるエンドポイントを作成します。

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

この例では、構成ファイルにエンドポイントを明示的に指定します。エンドポイントをサービスに追加しない場合、ランタイムによって既定のエンドポイントが追加されます。既定のエンドポイント、バインディング、および動作の詳細については、「簡略化された構成」と「WCF サービスの簡略化された構成」を参照してください。

サービスが正確にホストされるようにするには、ブラウザーを開き、サービスの URL (http://localhost/IISHostedCalc/Service.svc) を参照します

例

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>

方法: IIS で WCF サービスをホストする

IIS でホストされるサービスを作成するには

例

関連項目

その他のリソース