Partilhar via


<adicionar> de <baseAddressPrefixFilter>

Representa um elemento de configuração que especifica um filtro pass-through, que fornece um mecanismo para escolher os enlaces adequados dos Serviços de Informação Internet (IIS) ao alojar uma aplicação do Windows Communication Foundation (WCF) no IIS.

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

Syntax

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

Atributos e Elementos

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

Atributos

Atributo Descrição
prefixo Um URI que é utilizado para corresponder a uma parte de um endereço base.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
<baseAddressPrefixFilters> Uma coleção de elementos de configuração que especificam filtros pass-through, que fornecem um mecanismo para escolher os enlaces do IIS adequados ao alojar uma aplicação do Windows Communication Foundation (WCF) no IIS.

Observações

Um filtro de prefixo fornece uma forma de os fornecedores de alojamento partilhados especificarem que URIs devem ser utilizados 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 o enlace a 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