<<system.serviceModel>>

Esta sección de configuración contiene todos los elementos de configuración de ServiceModel de 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>

Atributos y elementos

Atributos

Ninguno

Elementos secundarios

Elemento	Descripción
<comportamientos>	Este elemento define dos colecciones secundarias denominadas endpointBehaviors y serviceBehaviors. Cada colección define los elementos de comportamiento utilizados respectivamente por extremos y servicios. Su atributo de name único identifica cada elemento de comportamiento.
<enlaces>	Este elemento contiene una colección de enlaces estándar y personalizados. Su name único identifica cada entrada. Los servicios utilizan los enlaces vinculándose a ellos mediante su name.
<cliente>	Este elemento contiene una lista de extremos que usa un cliente para conectar a un servicio.
<comContracts>	Este elemento define contratos COM habilitados para WCF e interoperabilidad COM.
<commonBehaviors>	Este elemento sólo se puede definir en el archivo machine.config. Define dos colecciones secundarias denominadas endpointBehaviors y serviceBehaviors. Cada colección define elementos de comportamiento utilizados respectivamente por todos los extremos WCF y servicios del equipo. Si un comportamiento se define en las secciones <commonBehaviors> y <behaviors>, el comportamiento en la sección <behaviors> tendrá preferencia.
Sección <extensions>	Este elemento de configuración contiene una colección de extensiones, que le permiten al usuario crear los enlaces definidos por el usuario, comportamientos y otros aspectos de las extensiones.
<diagnóstico>	Este elemento contiene la configuración de las características de diagnóstico de WCF. El usuario puede habilitar/deshabilitar el seguimiento, contadores de rendimiento y el proveedor de WMI, y puede agregar filtros de mensajes personalizados.
<serviceHostingEnvironment>	Este elemento define para qué tipo el entorno de host de servicio crea instancias de un transporte determinado. Si esta sección está vacía, se usa el tipo predeterminado.
<servicios>	El elemento contiene una colección de servicios. Para cada servicio definido en el ensamblado, este elemento contiene un elemento service que especifica la configuración del servicio.

Elementos primarios

Elemento	Descripción
<configuración>	El elemento raíz para todos los elementos de configuración en un archivo de configuración .NET.

Comentarios

WCF no agrega elementos a las secciones de configuración de otros productos.

Los servicios WCF se definen en la sección services del archivo de configuración. Un ensamblado puede contener cualquier número de servicios. Cada servicio tiene su propia sección de configuración de service. La sección y su contenido definen el contrato de servicios, comportamiento y extremos del servicio determinado.

Sólo se requiere el atributo de name del servicio. De forma predeterminada, el nombre de un servicio describe el tipo CLR subyacente usado para implementar un servicio; sin embargo, puede cambiar la propiedad ConfigurationName en ServiceContractAttribute para invalidar el requisito de tipo de CLR.

El atributo behaviorConfiguration es opcional. Identifica el comportamiento del servicio usado por un servicio. El comportamiento especificado por este atributo debe vincularse a un comportamiento del servicio definido en el ámbito del mismo archivo de configuración (es decir, el mismo archivo o un archivo primario).

Cada servicio expone uno o más extremos definidos en un elemento endpoint. Cada extremo tiene su propia dirección y enlace. Todos los enlaces usados dentro del archivo de configuración se deben definir en el ámbito del archivo.

Los enlaces se vinculan a los extremos a través de la combinación de los atributos name y bindingConfiguration. El atributo de binding define la sección en que está definido el enlace. El atributo bindingConfiguration define el enlace configurado que se usa en la sección de enlaces. Una sección de enlaces puede definir varios enlaces configurados.

Ejemplo

Esto es un ejemplo de un archivo de configuración de 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>

Consulte también

Referencia

ServiceModelSectionGroup