Partager via

<baseAddressPrefixFilters>

Représente une collection d’éléments de configuration qui spécifient des filtres transmis, 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 Windows Communication Foundation (WCF) dans IIS.

Avertissement

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

<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.

Attributes

Aucun.

Éléments enfants

Élément Descriptif
<ajouter> Ajoute un élément de configuration qui spécifie un filtre de préfixe pour les adresses de base utilisées par l’hôte de service.

Éléments parents

Élément Descriptif
<serviceHostingEnvironment> Définit le type que l’environnement d’hébergement de service instancie pour un transport particulier.

Remarques

Un filtre de préfixe permet aux fournisseurs d’hébergement partagés de spécifier les URI à utiliser par le service. Il permet aux hôtes partagés d’héberger plusieurs applications avec différentes adresses de base pour le même schéma sur le même site.

Les sites web IIS sont des conteneurs pour les applications virtuelles qui contiennent des répertoires virtuels. L’application d’un site est accessible via une ou plusieurs liaisons IIS. Les liaisons IIS fournissent deux informations : le protocole de liaison et les informations de liaison. Le protocole de liaison (par exemple, HTTP) définit le schéma sur lequel se produit la communication et les informations de liaison (par exemple, adresse IP, port, hôte) contiennent des données utilisées pour accéder au site.

IIS prend en charge la spécification de plusieurs liaisons IIS pour chaque site, ce qui entraîne plusieurs adresses de base pour chaque schéma. Étant donné qu’un service WCF hébergé sous un site autorise la liaison à 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 requise du service hébergé. Les adresses de base entrantes, fournies par IIS, sont filtrées en fonction du filtre de liste de préfixes facultatif.

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 du domaine d’application.

<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 pour leurs schémas respectifs, qui sont autorisées à être transmises.

Par défaut, lorsque le préfixe n’est pas spécifié, toutes les adresses sont transmises. La spécification du préfixe autorise uniquement l’adresse de base correspondante pour ce schéma à passer.

Note

Le filtre ne prend pas en charge les caractères génériques. En outre, les adresses baseAddresses fournies par IIS peuvent avoir des adresses liées à d’autres schémas non présents dans la baseAddressPrefixFilters liste. Ces adresses ne sont pas filtrées.

Voir aussi

  • Last updated on