Compartir a través de


<<system.serviceModel>>

Esta sección de configuración contiene todos los elementos de configuración de ServiceModel de Windows Communication Foundation (WCF).

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Ninguno

Elementos secundarios

Elemento Descripción

<comportamientos>

Esta sección define dos colecciones secundarias denominadas endpointBehaviors y serviceBehaviors. Cada colección define los elementos de comportamiento utilizados respectivamente por extremos y servicios. Su atributo name único identifica cada elemento de comportamiento.

<enlaces>

Esta sección 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 el atributo name.

<cliente>

Esta sección contiene una lista de extremos que usa un cliente para conectarse a un servicio.

<comContracts>

Esta sección define contratos COM habilitados para WCF e interoperabilidad COM.

<commonBehaviors>

Esta sección solo 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>

Esta sección contiene una colección de extensiones, que permiten al usuario crear los enlaces definidos por el usuario, comportamientos y otros aspectos de las extensiones.

<diagnóstico>

Esta sección contiene la configuración para las características de diagnóstico de WCF. El usuario puede habilitar/deshabilitar la traza, los contadores de rendimiento y el proveedor de WMI, y puede agregar filtros de mensajes personalizados.

<protocolMapping>

En esta sección se define un conjunto de asignación de protocolos predeterminados entre los esquemas de protocolos de transporte (ej., http, net.tcp, net.pipe, etc.) y enlaces WCF.

<enrutar>

Esta sección define un conjunto de filtros de enrutamiento, que determina el tipo de MessageFilter de Windows Communication Foundation (WCF) que se va a utilizar al evaluar los mensajes entrantes, así como las tablas de enrutamiento que definen los extremos de destino a los que se van a enviar mensajes cuando coincida un filtro.

<serviceHostingEnvironment>

Esta sección 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>

Esta sección 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.

<standardEndpoints>

Esta sección define una colección de extremos estándar, que son los extremos preconfigurados reutilizables. Un extremo estándar tendrá uno o más atributos de la dirección, el enlace y el contrato establecidos en un valor fijo. Por ejemplo, en el extremo de la detección el contrato es fijo. También puede usar los extremos estándar para extender el extremo de servicio con nuevas propiedades similares a la definición de enlaces personalizados.

Elementos primarios

Elemento Descripción

<configuration>

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

Notas

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>

Vea también

Referencia

ServiceModelSectionGroup