<baseAddressPrefixFilters>

Article
09/12/2008

Représente une collection d'éléments de configuration spécifiant des filtres directs qui fournissent un mécanisme permettant de sélectionner les liaisons de services IIS appropriées lors de l'hébergement d'une l'application Windows Communication Foundation (WCF) dans IIS.

<system.serviceModel>
<serviceHostingEnvironment>

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

Attributs et éléments

Attributs

Aucun.

Éléments enfants

Élément	Description
<add> de <baseAddressPrefixFilter>	Ajoute un élément de configuration spécifiant un filtre de préfixe pour les adresses de base utilisées par l'hôte de service.

Éléments parents

Élément	Description
<serviceHostingEnvironment>	Définit le type instancié par l'environnement d'hébergement du service pour un transport particulier.

Notes

Un filtre de préfixe permet aux fournisseurs d'hébergement partagé de spécifier les URI que le service doit utiliser. Il permet aux hôtes partagés d'héberger plusieurs applications avec différentes adresses de base pour la même méthode sur le même site.

Les sites Web IIS sont des conteneurs d'applications virtuelles qui contiennent des répertoires virtuels. L'application dans un site est accessible par le biais d'une ou de plusieurs liaisons IIS. Les liaisons IIS fournissent deux informations : un protocole de liaison et des informations de liaison. Le protocole de liaison (par exemple, HTTP) définit le modèle sur lequel la communication se produit, tandis que les informations de liaison (par exemple, adresse IP, port, en-tête de l'hôte) contiennent les données servant à accéder au site.

IIS prend en charge la spécification de plusieurs liaisons IIS pour chaque site, ce qui génère plusieurs adresses de base pour chaque méthode. Étant donné qu'un service WCF hébergé sur un site autorise la liaison avec une seule adresse de base pour chaque modèle, vous pouvez utiliser la fonctionnalité du filtre de préfixe pour choisir l'adresse de base requise du service hébergé. Les adresses de base entrantes, fournies par IIS, sont filtrées selon le filtre de la liste de préfixes facultative.

Par exemple, votre site peut contenir les adresses de base suivantes.

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

Vous pouvez utiliser le fichier de configuration suivant pour spécifier un filtre de préfixe au niveau AppDomain.

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

Dans cet exemple, net.tcp://test1.fabrikam.com:8000 et http://test2.fabrikam.com:9000 sont les seules adresses de base pouvant être passées pour leur modèle respectif.

Par défaut, si aucun préfixe n'est spécifié, toutes les adresses sont passées. La spécification du préfixe autorise uniquement de passer l'adresse de base correspondante pour ce modèle.

Remarque :
Le filtre ne prend pas en charge les caractères génériques. En outre, les adresses de base fournies par IIS peuvent avoir des adresses liées à d'autres modèles non présents dans la liste baseAddressPrefixFilters. Ces adresses ne sont pas éliminées par filtrage.