<baseAddressPrefixFilters>

[アーティクル]
09/12/2008

パススルーフィルタを指定する構成要素のコレクションを表します。パススルーフィルタには、インターネットインフォメーションサービス (IIS) で Windows Communication Foundation (WCF) アプリケーションをホストする場合に適切な IIS バインドを選択する機構が用意されています。

<system.serviceModel>
<serviceHostingEnvironment>

<serviceHostingEnvironment>
     <baseAddressPrefixFilters>
        <add prefix="string"/>
     </baseAddressPrefixFilters>
</serviceHostingEnvironment>

属性および要素

属性

なし。

子要素

要素	説明
<baseAddressPrefixFilter> の <add>	サービスホストによって使用されるベースアドレスのプレフィックスフィルタを指定する構成要素を追加します。

親要素

要素	説明
<serviceHostingEnvironment>	環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。

解説

プレフィックスフィルタは、サービスによって使用される URI を、共有ホスティングプロバイダが指定できるようにする手段を提供します。これにより、共有ホストは、同じサイト上の同じスキームに対して、別々のベースアドレスを使用して複数のアプリケーションをホストできるようになります。

IIS Web サイトは、仮想ディレクトリを含む仮想アプリケーションのコンテナです。サイト内のアプリケーションには、1 つ以上の IIS バインディングからアクセスできます。IIS バインディングは、バインディングプロトコルとバインディング情報という 2 つの情報を提供します。バインディングプロトコル (HTTP など) は通信を行うスキームを定義し、バインディング情報 (IP アドレス、ポート、ホストヘッダーなど) にはサイトにアクセスするために使用するデータが含まれます。

IIS では、サイトごとに複数の IIS バインディングを指定できるので、各スキームに複数のベースアドレスが定義されることがあります。これに対して、サイトでホストされる WCF サービスでは、スキームごとに 1 つのベースアドレスにしかバインドできません。そこで、プレフィックスフィルタ機能を使用すると、ホストされるサービスの必要なベースアドレスを選択できます。IIS によって指定される受信ベースアドレスは、オプションのプレフィックスリストフィルタに基づいてフィルタ処理されます。

たとえば、サイトに次のベースアドレスが含まれているとします。

http://testl.fabrikam.com/Service.svc
http://test2.fabrikam.com/Service.svc

次の構成ファイルを使用して、appdomain レベルでプレフィックスフィルタを指定できます。

<system.serviceModel>
  <serviceHostingEnvironment>
     <baseAddressPrefixFilters>
        <add prefix=”net.tcp://test1.fabrikam.com:8000”/>
        <add prefix=”http://test2.fabrikam.com:9000”/>
    </baseAddressPrefixFilters>
  </serviceHostingEnvironment>
</system.serviceModel>

この例では、net.tcp://test1.fabrikam.com:8000 と http://test2.fabrikam.com:9000 が、対応するスキームに渡される唯一のベースアドレスです。

既定では、プレフィックスを指定しない場合、すべてのアドレスが渡されます。プレフィックスだけを指定すると、そのスキームに一致するベースアドレスを渡すことができます。

メモ :
フィルタでワイルドカードはサポートされません。また、IIS が提供する baseAddresses には、baseAddressPrefixFilters リストに存在しない他のスキームにバインドされたアドレスが含まれる場合があります。これらのアドレスはフィルタで除外されません。

次の方法で共有

<baseAddressPrefixFilters>

属性および要素

属性

子要素

親要素

解説

関連項目

リファレンス

その他の技術情報

その他のリソース