Compartilhar via


<baseAddressPrefixFilters>

Representa uma coleção de elementos de configuração que especificam filtros de passagem, que fornecem um mecanismo para escolher as associações apropriadas dos Serviços de Informações da Internet (IIS) ao hospedar o aplicativo WCF (Windows Communication Foundation) no IIS.

Aviso

<baseAddressPrefixFilters> não reconhece "localhost"; use o nome do computador totalmente qualificado.

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

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Nenhum.

Elementos filho

Elemento Descrição
<add> Adiciona um elemento de configuração que especifica um filtro de prefixo para os endereços base usados pelo host de serviço.

Elementos pai

Elemento Descrição
<serviceHostingEnvironment> Define o tipo que o ambiente de hospedagem de serviço instancia para um transporte específico.

Comentários

Um filtro de prefixo fornece uma maneira de os provedores de hospedagem compartilhados especificarem quais URIs devem ser usadas pelo serviço. Ele permite que hosts compartilhados hospedem vários aplicativos com endereços base diferentes para o mesmo esquema no mesmo site.

Sites do IIS são contêineres para aplicativos virtuais que contêm diretórios virtuais. O aplicativo em um site pode ser acessado por meio de uma ou mais associações do IIS. As associações do IIS fornecem duas informações: protocolo de associação e informações de associação. O protocolo binding (por exemplo, HTTP) define o esquema sobre o qual a comunicação ocorre e as informações de associação (por exemplo, Endereço IP, Porta, Hostheader) contêm dados usados para acessar o site.

O IIS dá suporte à especificação de várias associações do IIS para cada site, o que resulta em vários endereços base para cada esquema. Como um serviço WCF hospedado em um site permite a associação a apenas um endereço base para cada esquema, você pode usar o recurso de filtro de prefixo para escolher o endereço base necessário do serviço hospedado. Os endereços base de entrada, fornecidos pelo IIS, são filtrados com base no filtro de lista de prefixo opcional.

Por exemplo, seu site pode conter os seguintes endereços base:

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

Você pode usar o arquivo de configuração a seguir para especificar um filtro de prefixo no nível do appdomain.

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

Neste exemplo, net.tcp://test1.fabrikam.com:8000 e http://test2.fabrikam.com:9000 são os únicos endereços base para seus respectivos esquemas, que têm permissão para serem passados.

Por padrão, quando o prefixo não é especificado, todos os endereços são passados. Especificar o prefixo só permite que o endereço base correspondente para esse esquema seja passado.

Observação

O filtro não dá suporte a curingas. Além disso, os baseAddresses fornecidos pelo IIS podem ter endereços associados a outros esquemas não presentes na baseAddressPrefixFilters lista. Esses endereços não são filtrados.

Confira também