<baseAddressPrefixFilters>

  • Article

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

Avertissement

<baseAddressPrefixFilters> ne reconnaît pas « localhost » ; utilisez plutôt le nom d’ordinateur complet.

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

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucune.

Éléments enfants

Élément Description
<add> 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 schéma, vous pouvez utiliser la fonctionnalité de filtre de préfixe pour choisir l’adresse de base nécessaire 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 transmises. La spécification du préfixe autorise uniquement la transmission de l'adresse de base correspondante pour ce modèle.

Notes

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.

Voir aussi