Compartilhar via


<add> de <baseAddressPrefixFilter>

Representa um elemento de configuração que especifica uma passagem pelo filtro, que fornece um mecanismo para coletar as associações de IIS apropriadas ao hospedar um aplicativo WCF (Windows Communication Foundation) no IIS.

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

Syntax

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

Atributos e elementos

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

Atributos

Atributo Descrição
prefixo Um URI que é usado para corresponder a uma parte de um endereço básico.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
<baseAddressPrefixFilters> Uma coleção de elementos de configuração que especificam filtros de passagem, que fornecem um mecanismo para escolher as associações IIS apropriadas ao hospedar um aplicativo WCF (Windows Communication Foundation) no IIS.

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