BaseAddressPrefixFilterElement クラス

定義

public ref class BaseAddressPrefixFilterElement sealed : System::Configuration::ConfigurationElement

public sealed class BaseAddressPrefixFilterElement : System.Configuration.ConfigurationElement

type BaseAddressPrefixFilterElement = class
    inherit ConfigurationElement

Public NotInheritable Class BaseAddressPrefixFilterElement
Inherits ConfigurationElement

継承

Object

ConfigurationElement

BaseAddressPrefixFilterElement

注釈

プレフィックス フィルター プロバイダーは、サービスが特定の URI にバインドするためのメカニズムです。 これにより、同じサイト上の同じスキームに対して異なるベース アドレスを持つ複数のアプリケーションをホストできます。

IIS Web サイトは、仮想ディレクトリを含む仮想アプリケーションのコンテナーです。 サイト内のアプリケーションには、1 つ以上の IIS バインドを使用してアクセスできます。 IIS バインドには、バインディング プロトコルとバインディング情報という 2 つの情報が用意されています。 バインディング プロトコル (HTTP など) は通信を行うスキームを定義し、バインディング情報 (IPAddress、Port、Hostheader など) にはサイトへのアクセスに使用されるデータが含まれます。

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 は、渡すことが許可されているそれぞれのスキームの唯一のベース アドレスです。

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