IIS と WAS における構成ベースのアクティブ化

  • [アーティクル]

インターネット インフォメーション サービス (IIS: Internet Information Services) または Windows プロセス アクティブ化サービス (WAS) で Windows Communication Foundation (WCF) サービスをホストする場合は、.svc ファイルを用意する必要があります。 .svc ファイルには、サービスの名前と、オプションのカスタム サービス ホスト ファクトリが含まれています。 この追加ファイルによって、管理のオーバーヘッドが増加します。 構成ベースのアクティブ化機能により、.svc ファイルを用意する必要がなくなり、関連するオーバーヘッドも発生しません。

構成ベースのアクティブ化

構成ベースのアクティブ化では、以前は .svc ファイルに配置されていたメタデータを受け取り、それを Web.config ファイルに配置します。 <serviceHostingEnvironment> 要素内に <serviceActivations> 要素があります。 <serviceActivations> 要素内には、1 つ以上の <add> 要素 (ホストされるサービスごとに 1 つ) があります。 <add> 要素には、サービスの相対アドレスと、サービス型またはサービス ホスト ファクトリを設定できる属性が含まれています。 次の構成コード例は、このセクションの使用方法を示しています。

Note

各 <add> 要素には、サービスまたはファクトリの属性を指定する必要があります。 サービスとファクトリ属性の両方を指定することもできます。

<serviceHostingEnvironment>
  <serviceActivations>
    <add relativeAddress="MyServiceAddress" service="Service" factory="MyServiceHostFactory"/>
  </serviceActivations>
</serviceHostingEnvironment>

このコードを Web.config ファイルに含めると、サービス ソース コードをアプリケーションの App_Code ディレクトリに配置するか、コンパイル済みアセンブリをアプリケーションの Bin ディレクトリに配置することができます。

Note

  • 構成ベースのアクティブ化機能を使用する場合、.svc ファイルのインライン コードはサポートされません。
  • relativeAddress 属性は、"<sub-directory>/service.svc" や "~/<sub-directory/service.svc" などの相対アドレスに設定する必要があります。
  • WCF と関連付けられている既知の拡張子を持たない相対アドレスを登録すると、構成例外がスローされます。
  • 指定された相対アドレスは、仮想アプリケーションのルートが基準になります。
  • 構成の階層的モデルにより、コンピューター レベルおよびサイト レベルの登録された相対アドレスは、仮想アプリケーションによって継承されます。
  • 構成ファイル内での登録は、.svc、.xamlx、.xoml、またはその他のファイルでの設定よりも優先されます。
  • IIS/WAS に送信された URI 内の \ (円記号) は、自動的に / (スラッシュ) に変換されます。 \ を含む相対アドレスが追加され、その相対アドレスを使用する URI を IIS に送信した場合は、円記号がスラッシュに変換されるため、IIS では、それを相対アドレスと一致させることができません。 IIS は、一致するものが見つからなかったことを示すトレース情報を送信します。

関連項目