Share via


<baseAddressPrefixFilters>

Stellt eine Auflistung der Konfigurationselemente dar, die Durchlauffilter mit einem Mechanismus zur Auswahl entsprechender IIS-Bindungen verwenden, wenn die Windows Communication Foundation (WCF)-Anwendung in IIS gehostet wird.

<<system.serviceModel>>
  <serviceHostingEnvironment>

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

Attribute und Elemente

Attribute

Keine.

Untergeordnete Elemente

Element Beschreibung

<add> von <baseAddressPrefixFilter>

Fügt ein Konfigurationselement hinzu, das einen Präfixfilter für die vom Diensthost verwendeten Basisadressen angibt.

Übergeordnete Elemente

Element Beschreibung

<serviceHostingEnvironment>

Definiert den Typ, der von der Diensthostumgebung für einen besonderen Transport instanziiert wird.

Hinweise

Ein Präfixfilter bietet gemeinsamen Hostanbietern eine Methode, um die vom Dienst zu verwendenden URIs anzugeben. Sie ermöglicht es gemeinsamen Hosts, mehrere Anwendungen mit unterschiedlichen Basisadressen für dasselbe Schema auf derselben Website zu hosten.

IIS-Websites sind Container für virtuelle Anwendungen, die virtuelle Verzeichnisse enthalten. Auf die Anwendung auf einer Website kann über eine oder mehrere IIS-Bindungen zugegriffen werden. IIS-Bindungen stellen zwei Angaben bereit: ein Bindungsprotokoll und Bindungsinformationen. Das Bindungsprotokoll (z. B. HTTP) definiert das Schema, über das die Kommunikation erfolgt, und Bindungsinformationen (z. B. IP-Address, Anschluss, Hostheader) enthalten Daten, die für den Zugriff auf die Website verwendet werden.

IIS unterstützt die Angabe mehrerer IIS-Bindungen für jede Website, was zu mehreren Basisadressen für jedes Schema führt. Da ein unter einer Website gehosteter WCF-Dienst nur die Bindung an eine Basisadresse für jedes Schema ermöglicht, können Sie mithilfe des Präfixfilters die erforderliche Basisadresse des gehosteten Dienstes auswählen. Die von IIS bereitgestellten eingehenden Basisadressen werden anhand des optionalen Präfixlistenfilters gefiltert.

Ihre Website kann beispielsweise die folgenden Basisadressen enthalten.

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

Sie können die folgende Konfigurationsdatei verwenden, um einen Präfixfilter auf AppDomain-Ebene anzugeben.

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

In diesem Beispiel sind net.tcp://test1.fabrikam.com:8000 und http://test2.fabrikam.com:9000 die einzigen Basisadressen für die jeweiligen Schemata, die übergeben werden können.

Standardmäßig werden alle Adressen übergeben, wenn kein Präfix angegeben ist. Wenn die Präfixergebnisse angegeben werden, wird nur die Basisadresse übergeben, die dem Schema entspricht.

Tipp

Der Filter unterstützt keine Platzhalter. Darüber hinaus verfügen die von IIS angegebenen Basisadressen möglicherweise über Adressen, die an andere, nicht in der baseAddressPrefixFilters-Liste vorhandene Schemata gebunden sind. Diese Adressen werden nicht herausgefiltert.

Siehe auch

Referenz

BaseAddressPrefixFilterElementCollection
ServiceHostingEnvironmentSection
ServiceHostingEnvironment

Weitere Ressourcen

Hosting