<add> von <baseAddressPrefixFilter>

Artikel
04/07/2023

Stellt ein Konfigurationselement dar, das einen Passthroughfilter angibt, der einen Mechanismus bieten, um die entsprechenden IIS-Bindungen (Internetinformationsdienste) auszuwählen, wenn eine WCF-Anwendung (Windows Communication Foundation) in IIS gehostet wird.

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	BESCHREIBUNG
prefix	Ein URI, der verwendet wird, um einen Teil einer Basisadresse abzugleichen.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
<baseAddressPrefixFilters>	Eine Auflistung von Konfigurationselementen, die Passthroughfilter angeben, mit denen die entsprechenden IIS-Bindungen ausgewählt werden können, wenn eine WCF-Anwendung (Windows Communication Foundation) in IIS gehostet 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.

Freigeben über