Compartir vía

<agregar><baseAddressPrefixFilter>

  • Artículo

Representa un elemento de configuración que especifica un filtro de tránsito, lo que proporciona un mecanismo para escoger los enlaces de Internet Information Services (IIS) adecuados al hospedar una aplicación Windows Communication Foundation (WCF) en IIS.

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

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

Atributo Descripción
prefix Un URI que se utiliza para coincidir con una parte de una dirección base.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
<baseAddressPrefixFilters> Una colección de elementos de configuración que especifican filtros de tránsito, lo que proporciona un mecanismo para escoger los enlaces de IIS adecuados al hospedar una aplicación Windows Communication Foundation (WCF) en IIS.

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 de un sitio a través de uno o varios 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 los 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