<baseAddressPrefixFilters>

  • Artículo

Representa una colección de elementos de configuración que especifica filtros de paso a través, que proporcionan un mecanismo para seleccionar los enlaces adecuados de Internet Information Server (IIS) al hospedar la aplicación de Windows Communication Foundation (WCF) en IIS.

Advertencia

<baseAddressPrefixFilters> no reconoce el «host local»; utilice el nombre de equipo completo en su lugar.

<configuración>
  <system.serviceModel>
    <serviceHostingEnvironment>
      <baseAddressPrefixFilters>

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción
<agregar> Agrega un elemento de configuración que especifica un filtro de prefijo para las direcciones base usadas por el host de servicio.

Elementos primarios

Elemento Descripción
<serviceHostingEnvironment> Define el tipo del que el entorno host del servicio crea instancias para un transporte determinado.

Comentarios

Un filtro de prefijo proporciona un método para que los proveedores de host compartido especifiquen qué identificadores URI va a utiliza el servicio. Permite a los host compartidos hospedar varias aplicaciones con direcciones base diferentes para el mismo esquema en el mismo sitio.

Los sitios web de IIS son los contenedores para las aplicaciones virtuales que contienen los directorios virtuales. Se puede tener acceso a la aplicación en un sitio a través de uno o más enlaces de IIS. Los enlaces de IIS proporcionan dos partes de información: protocolo de enlace e información de enlace. El protocolo de enlace (por ejemplo, HTTP), define el esquema sobre el que la comunicación se produce y la información de enlace (por ejemplo, IPAddress, Puerto, Hostheader) contiene los datos utilizados para tener acceso al sitio.

IIS admite la especificación de varios enlaces IIS para cada sitio, lo que tiene como resultado varias direcciones base para cada esquema. Puesto que un servicio WCF hospedado bajo un sitio permite el enlace a solo una dirección base por cada esquema, se puede utilizar la característica de filtro de prefijo para escoger la dirección base necesaria del servicio hospedado. Las direcciones base de entrada, proporcionadas por IIS, se filtran dependiendo del filtro de la lista de prefijos opcional.

Por ejemplo, su sitio puede contener las direcciones base siguientes:

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

Puede utilizar el archivo de configuración siguiente para especificar un filtro del prefijo en el nivel appdomain.

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

En este ejemplo, net.tcp://test1.fabrikam.com:8000 y http://test2.fabrikam.com:9000 son las únicas direcciones base para sus respectivos esquemas, a través de los que se puede pasar.

De forma predeterminada, cuando no se especifica el prefijo, se pasan todas las direcciones. Especificar el prefijo permite que solo la dirección base coincidente para ese esquema se pase a través.

Nota

El filtro no admite ningún carácter comodín. Además, las direcciones base proporcionadas por IIS pueden tener direcciones enlazadas a otros esquemas no presentes en la lista baseAddressPrefixFilters. Estas direcciones no se filtran.

Consulte también