Partilhar via


<baseAddressPrefixFilters>

Representa uma coleção de elementos de configuração que especificam filtros pass through, que fornecem um mecanismo para escolher os enlaces dos Serviços de Informação Internet (IIS) adequados ao alojar a aplicação Windows Communication Foundation (WCF) no IIS.

Aviso

<baseAddressPrefixFilters> não reconhece "localhost"; em vez disso, utilize o nome do computador completamente qualificado.

<configuração>
  <system.serviceModel>
    <serviceHostingEnvironment>
      <baseAddressPrefixFilters>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Nenhum.

Elementos Subordinados

Elemento Descrição
<adicionar> Adiciona um elemento de configuração que especifica um filtro de prefixo para os endereços base utilizados pelo anfitrião do serviço.

Elementos Principais

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

Observações

Um filtro de prefixo fornece uma forma de os fornecedores de alojamento partilhados especificarem os URIs a utilizar pelo serviço. Permite que os anfitriões partilhados alojem várias aplicações com endereços base diferentes para o mesmo esquema no mesmo site.

Os Web sites do IIS são contentores para aplicações virtuais que contêm diretórios virtuais. A aplicação num site pode ser acedida através de um ou mais enlaces do IIS. Os enlaces do IIS fornecem duas informações: protocolo de enlace e informações de enlace. O protocolo de enlace (por exemplo, HTTP) define o esquema sobre o qual ocorre a comunicação e as informações de enlace (por exemplo, Endereço IP, Porta, Hostheader) contêm dados utilizados para aceder ao site.

O IIS suporta a especificação de vários enlaces do IIS para cada site, o que resulta em vários endereços base para cada esquema. Uma vez que um serviço WCF alojado num site permite vincular apenas um endereço base para cada esquema, pode utilizar a funcionalidade de filtro de prefixo para escolher o endereço base necessário do serviço alojado. Os endereços base recebidos, fornecidos pelo IIS, são filtrados com base no filtro de lista de prefixos opcional.

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

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

Pode utilizar o seguinte ficheiro de configuração para especificar um filtro de prefixo ao 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 os respetivos esquemas, que podem ser transmitidos.

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

Nota

O filtro não suporta carateres universais. Além disso, os endereços base fornecidos pelo IIS podem ter endereços vinculados a outros esquemas que não estão presentes na baseAddressPrefixFilters lista. Estes endereços não estão filtrados.

Ver também