Condividi tramite


<baseAddressPrefixFilters>

Rappresenta una raccolta di elementi di configurazione che specificano filtri pass-through, che forniscono un meccanismo per selezionare le associazioni Internet Information Services (IIS) appropriate durante l'hosting dell'applicazione Windows Communication Foundation (WCF) in IIS.

Avvertimento

<baseAddressPrefixFilters> non riconosce "localhost"; usare invece il nome completo del computer.

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

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributes

Nessuno.

Elementi figli

Elemento Description
<Aggiungere> Aggiunge un elemento di configurazione che specifica un filtro di prefisso per gli indirizzi di base usati dall'host del servizio.

Elementi padre

Elemento Description
<serviceHostingEnvironment> Definisce il tipo di cui l'ambiente di hosting del servizio crea un'istanza per un trasporto specifico.

Osservazioni:

Un filtro di prefisso consente ai provider di hosting condivisi di specificare quali URI devono essere usati dal servizio. Consente agli host condivisi di ospitare più applicazioni con indirizzi di base diversi per lo stesso schema nello stesso sito.

I siti Web IIS sono contenitori per applicazioni virtuali che contengono directory virtuali. È possibile accedere all'applicazione in un sito tramite una o più associazioni IIS. Le associazioni IIS forniscono due informazioni: protocollo di associazione e informazioni di associazione. Il protocollo di associazione (ad esempio, HTTP) definisce lo schema su cui si verifica la comunicazione e le informazioni di associazione (ad esempio, indirizzo IP, porta, hostheader) contengono i dati usati per accedere al sito.

IIS supporta la specifica di più associazioni IIS per ogni sito, che comporta più indirizzi di base per ogni schema. Poiché un servizio WCF ospitato in un sito consente l'associazione a un solo indirizzo di base per ogni schema, è possibile usare la funzionalità di filtro del prefisso per selezionare l'indirizzo di base richiesto del servizio ospitato. Gli indirizzi di base in ingresso, forniti da IIS, vengono filtrati in base al filtro dell'elenco di prefissi facoltativo.

Ad esempio, il sito può contenere gli indirizzi di base seguenti:

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

È possibile usare il file di configurazione seguente per specificare un filtro di prefisso a livello di dominio app.

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

In questo esempio net.tcp://test1.fabrikam.com:8000 e http://test2.fabrikam.com:9000 sono gli unici indirizzi di base per i rispettivi schemi, che possono essere passati.

Per impostazione predefinita, quando non si specifica il prefisso, tutti gli indirizzi vengono passati. Se si specifica il prefisso, è possibile passare solo l'indirizzo di base corrispondente per tale schema.

Annotazioni

Il filtro non supporta caratteri jolly. Inoltre, gli oggetti baseAddresses forniti da IIS possono avere indirizzi associati ad altri schemi non presenti nell'elenco baseAddressPrefixFilters . Questi indirizzi non vengono filtrati.

Vedere anche