<add> di <baseAddressPrefixFilter><add> of <baseAddressPrefixFilter>

Rappresenta un elemento di configurazione che specifica un filtro pass-through che fornisce un meccanismo per scegliere le associazioni di Internet Information Services (IIS) appropriate quando si ospita un'applicazione Windows Communication Foundation (WCF) in IIS.Represents a configuration element that specifies a pass-through filter, which provides a mechanism to pick the appropriate Internet Information Services (IIS) bindings when hosting a Windows Communication Foundation (WCF) application in IIS.

<system.ServiceModel><system.ServiceModel>
<ServiceHostingEnvironment ><ServiceHostingEnvironment>
<baseAddressPrefixFilters ><baseAddressPrefixFilters>
<add><add>

SintassiSyntax

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

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
prefixprefix URI usato per la corrispondenza a una parte di un indirizzo di base.A URI that is used to match a part of a base address.

Elementi figlioChild Elements

Nessuno.None.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
<baseAddressPrefixFilters ><baseAddressPrefixFilters> Una raccolta di elementi di configurazione che specificano filtri pass-through, che forniscono un meccanismo per scegliere le associazioni di IIS appropriate quando si ospita un'applicazione Windows Communication Foundation (WCF) in IIS.A collection of configuration elements that specify pass-through filters, which provide a mechanism to pick the appropriate IIS bindings when hosting a Windows Communication Foundation (WCF) application in IIS.

NoteRemarks

Un filtro dei prefissi fornisce ai provider di hosting condiviso una modalità per specificare quali URI devono essere usati dal servizio.A prefix filter provides a way for shared hosting providers to specify which URIs are to be used by the service. Consente agli host condivisi di ospitare più applicazioni con indirizzi di base diversi per lo stesso schema nello stesso sito.It enables shared hosts to host multiple applications with different base addresses for the same scheme on the same site.

I siti Web IIS sono contenitori di applicazioni virtuali che contengono directory virtuali.IIS Web sites are containers for virtual applications which contain virtual directories. È possibile accedere all'applicazione in un sito tramite una o più associazioni IIS.The application in a site can be accessed through one or more IIS binding. Le associazioni IIS forniscono due tipi di informazioni: un protocollo di associazione e informazioni di associazione.IIS bindings provide two pieces of information: binding protocol and binding information. 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.Binding protocol (for example, HTTP) defines the scheme over which communication occurs, and binding information (for example, IP Address, Port, Hostheader) contains data used to access the site.

IIS supporta la definizione di più associazioni IIS per ogni sito, che si traduce in più indirizzi di base per ogni schema.IIS supports specifying multiple IIS bindings for each site, which results in multiple base addresses for each scheme. Poiché un servizio WCF ospitato in un sito consente l'associazione a un solo indirizzo di basa per ogni schema, è possibile utilizzare la funzionalità di filtro dei prefissi per scegliere l'indirizzo di basa necessario del servizio ospitato.Because a WCF service hosted under a site allows binding to only one base address for each scheme, you can use the prefix filter feature to pick the required base address of the hosted service. Gli indirizzi di base in ingresso forniti da IIS sono filtrati in base all'elenco di prefissi facoltativo.The incoming base addresses, supplied by IIS, are filtered based on the optional prefix list filter.

Un sito può ad esempio contenere gli indirizzi di base seguenti.For example, your site can contain the following base addresses.

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.You can use the following configuration file to specify a prefix filter at the appdomain level.

<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 i soli indirizzi di base che è consentito attraversare per i rispettivi schemi.In this example, net.tcp://test1.fabrikam.com:8000 and http://test2.fabrikam.com:9000 are the only base addresses for their respective schemes which are allowed to be passed through.

Per impostazione predefinita, quando non è specificato un prefisso, vengono passati tutti gli indirizzi.By default, when prefix is not specified, all addresses are passed through. La definizione del prefisso fa in modo che venga passato solo l'indirizzo di base corrispondente allo schema specifico.Specifying the prefix only allows the matching base address for that scheme to be passed through.

Nota

Il filtro non supporta caratteri jolly.The filter does not support any wildcards. Gli indirizzi di base forniti da IIS possono inoltre disporre di indirizzi associati ad altri schemi non presenti nell'elenco baseAddressPrefixFilters.In addition, the baseAddresses supplied by IIS may have addresses bound to other schemes not present in the baseAddressPrefixFilters list. Questi indirizzi non vengono filtrati.These addresses are not filtered out.

Vedere ancheSee Also

BaseAddressPrefixFilterElement
ServiceHostingEnvironmentSection
ServiceHostingEnvironment
HostingHosting