<baseAddressPrefixFilters ><baseAddressPrefixFilters>

パススルーフィルターを指定する構成要素のコレクションを表します。パススルーフィルターは、IIS で Windows Communication Foundation (WCF) アプリケーションをホストするときに適切なインターネットインフォメーションサービス (IIS) バインドを選択するメカニズムを提供します。Represents a collection of configuration elements that specify pass through filters, which provide a mechanism to pick the appropriate Internet Information Services (IIS) bindings when hosting the Windows Communication Foundation (WCF) application in IIS.

警告

<baseAddressPrefixFilters > は "localhost" を認識しません。代わりに、完全修飾コンピューター名を使用してください。<baseAddressPrefixFilters> does not recognize "localhost"; use the fully qualified machine name instead.

<configuration> <configuration>
    <system >   <system.serviceModel>
     <serviceHostingEnvironment >     <serviceHostingEnvironment>
      <baseAddressPrefixFilters >      <baseAddressPrefixFilters>

構文Syntax

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

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

なし。None.

子要素Child Elements

要素Element 説明Description
<add><add> サービス ホストによって使用されるベース アドレスのプレフィックス フィルターを指定する構成要素を追加します。Adds a configuration element that specifies a prefix filter for the base addresses used by the service host.

親要素Parent Elements

要素Element 説明Description
<serviceHostingEnvironment ><serviceHostingEnvironment> 環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。Defines the type the service hosting environment instantiates for a particular transport.

RemarksRemarks

プレフィックス フィルターは、サービスによって使用される URI を、共有ホスティング プロバイダーが指定できるようにする手段を提供します。A prefix filter provides a way for shared hosting providers to specify which URIs are to be used by the service. これにより、共有ホストは、同じサイト上の同じスキームに対して、別々のベース アドレスを使用して複数のアプリケーションをホストできるようになります。It enables shared hosts to host multiple applications with different base addresses for the same scheme on the same site.

IIS Web サイトは、仮想ディレクトリを含む仮想アプリケーションのコンテナーです。IIS Web sites are containers for virtual applications which contain virtual directories. サイト内のアプリケーションには、1 つ以上の IIS バインディングからアクセスできます。The application in a site can be accessed through one or more IIS bindings. IIS バインディングは、バインディング プロトコルとバインディング情報という 2 つの情報を提供します。IIS bindings provide two pieces of information: binding protocol and binding information. バインディング プロトコル (HTTP など) は通信を行うスキームを定義し、バインディング情報 (IP アドレス、ポート、ホスト ヘッダーなど) にはサイトにアクセスするために使用するデータが含まれます。Binding protocol (for example, HTTP) defines the scheme over which communication occurs, and binding information (for example, IP Address, Port, Hostheader) contains data used to access the site.

IIS では、サイトごとに複数の IIS バインディングを指定できるので、各スキームに複数のベース アドレスが定義されることがあります。IIS supports specifying multiple IIS bindings for each site, which results in multiple base addresses for each scheme. サイトでホストされる WCF サービスでは、スキームごとに1つのベースアドレスにしかバインドできないため、プレフィックスフィルター機能を使用して、ホステッドサービスの必要なベースアドレスを選択できます。Because a WCF service hosted under a site allows binding to only one base address for each scheme, you can use the prefix filter feature to pick the required base address of the hosted service. IIS によって指定される受信ベース アドレスは、オプションのプレフィックス リスト フィルターに基づいてフィルター処理されます。The incoming base addresses, supplied by IIS, are filtered based on the optional prefix list filter.

たとえば、サイトに次のベースアドレスを含めることができます。For example, your site can contain the following base addresses:

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

次の構成ファイルを使用して、appdomain レベルでプレフィックス フィルターを指定できます。You can use the following configuration file to specify a prefix filter at the appdomain level.

<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:8000http://test2.fabrikam.com:9000 が、対応するスキームに渡される唯一のベース アドレスです。In this example, net.tcp://test1.fabrikam.com:8000 and http://test2.fabrikam.com:9000 are the only base addresses for their respective schemes, which are allowed to be passed through.

既定では、プレフィックスを指定しない場合、すべてのアドレスが渡されます。By default, when prefix is not specified, all addresses are passed through. プレフィックスだけを指定すると、そのスキームに一致するベース アドレスを渡すことができます。Specifying the prefix only allows the matching base address for that scheme to be passed through.

注意

フィルターでワイルドカードはサポートされません。The filter does not support any wildcards. また、IIS が提供する baseAddresses には、baseAddressPrefixFilters リストに存在しない他のスキームにバインドされたアドレスが指定される場合があります。In addition, the baseAddresses supplied by IIS may have addresses bound to other schemes not present in the baseAddressPrefixFilters list. これらのアドレスはフィルターで除外されません。These addresses are not filtered out.

関連項目See also