<baseAddressPrefixFilters>
Vertegenwoordigt een verzameling configuratie-elementen die passthrough-filters opgeven, die een mechanisme bieden om de juiste IIS-bindingen (Internet Information Services) te kiezen bij het hosten van de WCF-toepassing (Windows Communication Foundation) in IIS.
Waarschuwing
<baseAddressPrefixFilters> herkent 'localhost' niet. Gebruik in plaats daarvan de volledig gekwalificeerde computernaam.
<Configuratie>
<system.serviceModel>
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
Syntax
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
<add prefix="String" />
</baseAddressPrefixFilters>
</serviceHostingEnvironment>
Kenmerken en elementen
In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.
Kenmerken
Geen.
Onderliggende elementen
Element | Beschrijving |
---|---|
<Toevoegen> | Hiermee voegt u een configuratie-element toe dat een voorvoegselfilter opgeeft voor de basisadressen die door de servicehost worden gebruikt. |
Bovenliggende elementen
Element | Beschrijving |
---|---|
<serviceHostingEnvironment> | Definieert het type dat de servicehostingomgeving voor een bepaald transport instanteert. |
Opmerkingen
Een voorvoegselfilter biedt gedeelde hostingproviders een manier om op te geven welke URI's door de service moeten worden gebruikt. Hiermee kunnen gedeelde hosts meerdere toepassingen met verschillende basisadressen hosten voor hetzelfde schema op dezelfde site.
IIS-websites zijn containers voor virtuele toepassingen die virtuele mappen bevatten. De toepassing in een site kan worden geopend via een of meer IIS-bindingen. IIS-bindingen bieden twee soorten informatie: bindingsprotocol en bindingsinformatie. Het bindingsprotocol (bijvoorbeeld HTTP) definieert het schema waarover communicatie plaatsvindt en bindingsgegevens (bijvoorbeeld IP-adres, poort, hostheader) bevatten gegevens die worden gebruikt voor toegang tot de site.
IIS ondersteunt het opgeven van meerdere IIS-bindingen voor elke site, wat resulteert in meerdere basisadressen voor elk schema. Omdat een WCF-service die wordt gehost onder een site slechts één basisadres voor elk schema kan binden, kunt u de functie voor het voorvoegselfilter gebruiken om het vereiste basisadres van de gehoste service te kiezen. De binnenkomende basisadressen, geleverd door IIS, worden gefilterd op basis van het optionele filter voor de lijst met voorvoegsels.
Uw site kan bijvoorbeeld de volgende basisadressen bevatten:
http://testl.fabrikam.com/Service.svc
http://test2.fabrikam.com/Service.svc
U kunt het volgende configuratiebestand gebruiken om een voorvoegselfilter op appdomeinniveau op te geven.
<system.serviceModel>
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
<add prefix="net.tcp://test1.fabrikam.com:8000" />
<add prefix="http://test2.fabrikam.com:9000" />
</baseAddressPrefixFilters>
</serviceHostingEnvironment>
</system.serviceModel>
In dit voorbeeld net.tcp://test1.fabrikam.com:8000
zijn en http://test2.fabrikam.com:9000
de enige basisadressen voor hun respectieve schema's, die mogen worden doorgegeven.
Wanneer geen voorvoegsel is opgegeven, worden standaard alle adressen doorgegeven. Als u het voorvoegsel opgeeft, kan alleen het overeenkomende basisadres voor dat schema worden doorgegeven.
Notitie
Het filter biedt geen ondersteuning voor jokertekens. Bovendien kunnen de baseAddresses die door IIS worden geleverd adressen hebben die zijn gebonden aan andere schema's die niet in de baseAddressPrefixFilters
lijst voorkomen. Deze adressen worden niet uitgefilterd.