<baseAddressPrefixFilters>
Stellt eine Auflistung der Konfigurationselemente dar, die Passthroughfilter mit einem Mechanismus zur Auswahl geeigneter IIS-Bindungen (Internetinformationsdienste) verwenden, wenn die WCF-Anwendung (Windows Communication Foundation) in IIS gehostet wird.
Warnung
<baseAddressPrefixFilters> erkennt nicht „localhost“. Verwenden Sie stattdessen den vollqualifizierten Computernamen.
<configuration>
<system.serviceModel>
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
Syntax
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
<add prefix="String" />
</baseAddressPrefixFilters>
</serviceHostingEnvironment>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Keine
Untergeordnete Elemente
| Element | BESCHREIBUNG |
|---|---|
| <add> | 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. |
Bemerkungen
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 der Funktion „Präfixfilter“ die erforderliche Basisadresse des gehosteten Diensts 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.
Hinweis
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.
