Condividi tramite

<FiltriPrefissoIndirizzoBase>

  • Articolo

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

Avviso

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

<Configurazione>
  <system.serviceModel>
    <serviceHostingEnvironment>
      <FiltriPrefissoIndirizzoBase>

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.

Attributi

Nessuno.

Elementi figlio

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

Elementi padre

Elemento Descrizione
<serviceHostingEnvironment> Definisce il tipo del quale l'ambiente host del servizio crea un'istanza per un determinato trasporto.

Commenti

Un filtro dei prefissi fornisce ai provider di hosting condiviso una modalità per 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 di applicazioni virtuali che contengono directory virtuali. È possibile accedere all'applicazione in un sito tramite una o più associazioni IIS. Le associazioni IIS forniscono due tipi di informazioni: un protocollo di associazione e informazioni di associazione. Il protocollo di associazione, ad esempio HTTP, definisce lo schema in base al quale viene stabilita la comunicazione, mentre le informazioni di associazione, ad esempio l'indirizzo IP, la porta, l'intestazione host, contengono i dati usati per accedere al sito.

IIS supporta la definizione di più associazioni IIS per ogni sito, che si traduce in 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à filtro prefisso per selezionare l'indirizzo di base necessario del servizio ospitato. Gli indirizzi di base in ingresso forniti da IIS sono filtrati in base all'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 dei prefissi a livello di AppDomain.

<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 che è consentito passare per i rispettivi schemi.

Per impostazione predefinita, quando non è specificato un prefisso, vengono passati tutti gli indirizzi. La definizione del prefisso fa in modo che venga passato solo l'indirizzo di base corrispondente allo schema specifico.

Nota

Il filtro non supporta caratteri jolly. Gli indirizzi di base forniti da IIS possono inoltre disporre di indirizzi associati ad altri schemi non presenti nell'elenco baseAddressPrefixFilters. Questi indirizzi non vengono filtrati.

Vedi anche