Freigeben über

<baseAddressPrefixFilters>

Stellt eine Auflistung von Konfigurationselementen dar, die Pass-Through-Filter angeben, die einen Mechanismus zum Auswählen der entsprechenden IIS-Bindungen (Internet Information Services) beim Hosten der Windows Communication Foundation (WCF)-Anwendung in IIS bereitstellen.

Warnung

<baseAddressPrefixFilters> erkennt "localhost" nicht; 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

Keiner.

Untergeordnete Elemente

Element Description
<hinzufügen> Fügt ein Konfigurationselement hinzu, das einen Präfixfilter für die vom Diensthost verwendeten Basisadressen angibt.

Übergeordnete Elemente

Element Description
<serviceHostingEnvironment> Definiert den Typ der Diensthostingumgebung, der für einen bestimmten Transport instanziiert wird.

Bemerkungen

Ein Präfixfilter bietet eine Möglichkeit für gemeinsam genutzte Hostinganbieter, um anzugeben, welche URIs vom Dienst verwendet werden sollen. Es ermöglicht gemeinsam genutzten 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 Informationselemente bereit: Bindungsprotokoll- und Bindungsinformationen. Das Bindungsprotokoll (z. B. HTTP) definiert das Schema, über das die Kommunikation erfolgt, und Bindungsinformationen (z. B. IP-Adresse, Port, Hostheader) enthält Daten, die für den Zugriff auf die Website verwendet werden.

IIS unterstützt die Angabe mehrerer IIS-Bindungen für jeden Standort, was zu mehreren Basisadressen für jedes Schema führt. Da ein unter einer Website gehosteter WCF-Dienst nur eine Basisadresse für jedes Schema zulässt, können Sie das Präfixfilterfeature verwenden, um die erforderliche Basisadresse des gehosteten Diensts zu wählen. Die von IIS bereitgestellten eingehenden Basisadressen werden basierend auf dem optionalen Präfixlistenfilter gefiltert.

Ihre Website kann z. B. 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 net.tcp://test1.fabrikam.com:8000 und http://test2.fabrikam.com:9000 sind die einzigen Basisadressen für ihre jeweiligen Schemas, die übergeben werden dürfen.

Wenn das Präfix nicht angegeben ist, werden standardmäßig alle Adressen übergeben. Durch Angeben des Präfixes kann nur die übereinstimmende Basisadresse für dieses Schema übergeben werden.

Hinweis

Der Filter unterstützt keine Wildcards. Darüber hinaus können die von IIS bereitgestellten baseAddresses Adressen an andere Schemas gebunden sein, die in der baseAddressPrefixFilters Liste nicht vorhanden sind. Diese Adressen werden nicht herausgefiltert.

Siehe auch

  • Last updated on