<system.serviceModel>

Articolo
09/12/2008

Questa sezione di configurazione contiene tutti gli elementi di configurazione del modello ServiceModel di Windows Communication Foundation (WCF).

<system.serviceModel>
    <behaviors>
    </behaviors>
    <bindings>
    </bindings>
    <client>
    </client>
    <comContracts>
    </comContracts>
    <commonBehaviors>
    </commonBehaviors>
    <diagnostics>
    </diagnostics>
    <extensions>
    </extensions>
    <serviceHostingEnvironment>
    </serviceHostingEnvironment>
    <services>
    </services>
</system.serviceModel>

Attributi ed elementi

Attributi

Nessuno

Elementi figlio

Elemento	Descrizione
<comportamenti>	Questo elemento definisce due insiemi figlio denominati endpointBehaviors e serviceBehaviors. Ogni insieme definisce elementi di comportamento utilizzati rispettivamente da endpoint e servizi. Ogni elemento behavior è identificato dal relativo attributo name.
<bindings>	Questo elemento contiene un insieme di associazioni standard e personalizzate. Ogni voce è identificata dal relativo attributo name univoco. I servizi utilizzano le associazioni collegandole mediante l'attributo name.
<client>	Questo elemento contiene un elenco di endpoint utilizzati da un client per connettersi a un servizio.
<comContracts>	Questo elemento definisce contratti COM attivati per garantire l'interoperabilità fra WCF e COM.
<comportamentiComuni>	Questo elemento, che può essere definito solo nel file machine.config, definisce due insiemi figlio denominati endpointBehaviors e serviceBehaviors. Ogni insieme definisce elementi di comportamento utilizzati rispettivamente da tutti gli endpoint WCF e dai servizi del computer. Se un comportamento viene definito in entrambe le sezioni <commonBehaviors> e <behaviors>, la preferenza viene assegnata a quello nella sezione <behaviors>.
Sezione <extensions>	Questo elemento di configurazione contiene un insieme di estensioni che consentono all'utente di creare associazioni definite dall'utente, comportamenti e altri aspetti delle estensioni.
<diagnostics>	Questo elemento contiene impostazioni per le funzionalità di diagnostica di WCF. L'utente può attivare o disattivare tracce, contatori di prestazioni e il provider WMI e può aggiungere filtri dei messaggi personalizzati.
<serviceHostingEnvironment>	Questo elemento definisce il tipo di cui l'ambiente host del servizio crea un'istanza per un determinato trasporto. Se questa sezione è vuota, viene utilizzato il tipo predefinito.
<servizi>	Questo elemento contiene un insieme di servizi. Per ogni servizio definito nell'assembly, questo elemento contiene un elemento service in cui vengono specificate le impostazioni del servizio.

Elementi padre

Elemento	Descrizione
<configurazione>	Elemento radice di tutti gli elementi di configurazione contenuti in un file di configurazione .NET.

Osservazioni

WCF non aggiunge elementi alle sezioni di configurazione di altri prodotti.

I servizi WCF vengono definiti nella sezione services del file di configurazione. Un assembly può contenere un numero qualsiasi di servizi. Ogni servizio dispone di una propria sezione di configurazione service. La sezione e il relativo contenuto definiscono in modo specifico il contratto, il comportamento e gli endpoint del servizio.

Fra gli attributi di un servizio, solo name è obbligatorio. Per impostazione predefinita, il nome di un servizio descrive il tipo CLR sottostante utilizzato per implementare un servizio. È tuttavia possibile modificare la proprietà ConfigurationName di un attributo ServiceContractAttribute per eseguire l'override del requisito del tipo CLR.

L'attributo facoltativo behaviorConfiguration identifica il comportamento utilizzato dal servizio. Il comportamento specificato da questo attributo deve essere collegato a un comportamento di servizio definito nell'ambito dello stesso file di configurazione, ad esempio lo stesso file o un file padre.

Ogni servizio espone uno o più endpoint definiti in un elemento endpoint. Ogni endpoint presenta indirizzo e associazione propri. Tutte le associazioni utilizzate all'interno del file di configurazione devono essere definite nell'ambito del file.

Le associazioni sono collegate agli endpoint tramite la combinazione di attributi name e bindingConfiguration. L'attributo binding definisce la sezione in cui è definita l'associazione. L'attributo bindingConfiguration definisce quale associazione configurata viene utilizzata fra quelle contenute nella sezione di associazione. Una sezione di associazione può infatti definire varie associazioni configurate.

Esempio

Segue un esempio di file di configurazione di WCF.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.serviceModel>
        <behaviors>
           <!-- List of Behaviors -->
        </behaviors>
        <client>
           <!-- List of Endpoints -->
        </client>
        <diagnostics wmiProviderEnabled="false" performanceCountersEnabled="false" tracingEnabled="false">
        </diagnostics>
        <serviceHostingEnvironment>
           <!-- List of entries -->
        </serviceHostingEnvironment>
        <comContracts>
           <!-- List of COM+ Contracts -->
        </comContracts>        
        <services>
           <!-- List of Services -->
        </services>
        <bindings>
           <!-- List of Bindings -->
        </bindings>
    </system.serviceModel>
</configuration>

Vedere anche

Riferimenti

ServiceModelSectionGroup

Condividi tramite