<system.serviceModel>

Esta seção de configuração contém todos os elementos de configuração de ServiceModel Windows Communication Foundation (WCF).This configuration section contains all the Windows Communication Foundation (WCF) ServiceModel configuration elements.

<configuration>
  <system.serviceModel>

SyntaxSyntax

<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>
  <tracking>
  </tracking>
</system.serviceModel>

Atributos e elementosAttributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

NenhumNone

Elementos filhoChild Elements

ElementoElement DescriçãoDescription
<behaviors> Esta seção define duas coleções filho chamadas endpointBehaviors e serviceBehaviors .This section defines two child collections named endpointBehaviors and serviceBehaviors. Cada coleção define elementos de comportamento consumidos por pontos de extremidade e serviços, respectivamente.Each collection defines behavior elements consumed by endpoints and services respectively. Cada elemento do comportamento é identificado por seu exclusivo name atributo.Each behavior element is identified by its unique name attribute.
<bindings> Esta seção contém uma coleção de associações padrão e personalizadas.This section holds a collection of standard and custom bindings. Cada entrada é identificada por seu exclusivo name .Each entry is identified by its unique name. Os serviços usam associações vinculando-os usando o name .Services use bindings by linking them using the name.
<client> Esta seção contém uma lista de pontos de extremidade que um cliente usa para se conectar a um serviço.This section contains a list of endpoints a client uses to connect to a service.
<comContracts> Esta seção define contratos COM habilitados para WCF e interoperabilidade COM.This section defines COM contracts enabled for WCF and COM interop.
<commonBehaviors> Esta seção só pode ser definida no arquivo de machine.config.This section can only be defined in the machine.config file. Ele define duas coleções filho chamadas endpointBehaviors e serviceBehaviors .It defines two child collections named endpointBehaviors and serviceBehaviors. Cada coleção define elementos de comportamento consumidos por todos os pontos de extremidade do WCF e serviços no computador, respectivamente.Each collection defines behavior elements consumed by all WCF endpoints and services on the machine respectively. Se um comportamento for definido em ambas <commonBehaviors> as <behaviors> seções e, o comportamento na <behaviors> seção terá preferência.If a behavior is defined in both <commonBehaviors> and <behaviors> sections, the behavior in the <behaviors> section is given preference.
<diagnostics> Esta seção contém configurações para os recursos de diagnóstico do WCF.This section contains settings for the diagnostics features of WCF. O usuário pode habilitar/desabilitar rastreamento, contadores de desempenho e o provedor WMI e pode adicionar filtros de mensagem personalizados.The user can enable/disable tracing, performance counters, and the WMI provider, and can add custom message filters.
<extensions> Esta seção contém uma coleção de extensões, que permitem ao usuário criar associações definidas pelo usuário, comportamentos e outros aspectos das extensões.This section contains a collection of extensions, which enable the user to create user-defined bindings, behaviors, and other aspects of extensions.
<protocolMapping> Esta seção define um conjunto de mapeamento de protocolo padrão entre esquemas de protocolo de transporte (por exemplo, http, net. TCP, net. pipe, etc.) e associações do WCF.This section defines a set of default protocol mapping between transport protocol schemes (e.g., http, net.tcp, net.pipe, etc.) and WCF bindings.
<routing> Esta seção define um conjunto de filtros de roteamento, que determinam o tipo de Windows Communication Foundation (WCF) MessageFilter a ser usado ao avaliar mensagens recebidas, bem como tabelas de roteamento que definem os pontos de extremidade de destino para envio de mensagens quando um filtro é correspondente.This section defines a set of routing filters, which determine the type of Windows Communication Foundation (WCF)MessageFilter to be used when evaluating incoming messages, as well as routing tables that define the target endpoints to send messages to when a filter matches.
<serviceHostingEnvironment> Esta seção define o tipo que o ambiente de Hospedagem de serviço instancia para um determinado transporte.This section defines what type the service hosting environment instantiates for a particular transport. Se esta seção estiver vazia, o tipo padrão será usado.If this section is empty, the default type is used.
<services> A seção contém uma coleção de serviços.The section contains a collection of services. Para cada serviço definido no assembly, esse elemento contém um service elemento que especifica as configurações para o serviço.For each service defined in the assembly, this element contains a service element specifying settings for the service.
<standardEndpoints> Esta seção define uma coleção de pontos de extremidade padrão, que são pontos de extremidade pré-configurados reutilizáveis.This section defines a collection of standard endpoints, which are reusable preconfigured endpoints. Um ponto de extremidade padrão terá um ou mais dos atributos de endereço, associação e contrato definidos como um valor fixo.A standard endpoint will have one or more of the address, binding and contract attributes set to a fixed value. Por exemplo, no ponto de extremidade de descoberta, o contrato é fixo.For example, in the discovery endpoint the contract is fixed. Você também pode usar pontos de extremidade padrão para estender o ponto final de serviço com novas propriedades semelhantes à definição de associações personalizadas.You can also use standard endpoints to extend service endpoint with new properties similar to defining custom bindings.
<tracking> Esta seção define as configurações de controle para um serviço de fluxo de trabalho.This section defines tracking settings for a workflow service.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
<configuration> O elemento raiz para todos os elementos de configuração em um arquivo de configuração do .NET.The root element for all configuration elements in a .NET configuration file.

ComentáriosRemarks

O WCF não adiciona elementos às seções de configuração de outros produtos.WCF does not add elements to the configuration sections of other products.

Os serviços WCF são definidos na services seção do arquivo de configuração.WCF services are defined in the services section of the configuration file. Um assembly pode conter qualquer número de serviços.An assembly can contain any number of services. Cada serviço tem sua própria service seção de configuração.Each service has its own service configuration section. A seção e seu conteúdo definem o contrato de serviço, o comportamento e os pontos de extremidade do serviço específico.The section and its content define the service contract, behavior, and endpoints of the particular service.

Somente um atributo de serviço name é necessário.Only a service's name attribute is required. Por padrão, o nome de um serviço descreve o tipo CLR subjacente usado para implementar um serviço; no entanto, você pode alterar a propriedade ConfigurationName em um ServiceContractAttribute para substituir o requisito de tipo CLR.By default, a service's name describes the underlying CLR type used to implement a service; however, you may change the ConfigurationName property on a ServiceContractAttribute to override the CLR type requirement.

O atributo behaviorConfiguration é opcional.The behaviorConfiguration attribute is optional. Ele identifica o comportamento do serviço usado por um serviço.It identifies the service behavior used by a service. O comportamento especificado por esse atributo deve ser vinculado a um comportamento de serviço definido no escopo do mesmo arquivo de configuração (ou seja, o mesmo arquivo ou um arquivo pai).The behavior specified by this attribute must link to a service behavior defined in the scope of the same configuration file (i.e. the same file or a parent file).

Cada serviço expõe um ou mais pontos de extremidade definidos em um endpoint elemento.Each service exposes one or more endpoints defined in an endpoint element. Cada ponto de extremidade tem seu próprio endereço e associação.Each endpoint has its own address and binding. Todas as associações usadas no arquivo de configuração devem ser definidas no escopo do arquivo.All bindings used within the configuration file must be defined in the scope of the file.

As associações são vinculadas a pontos de extremidade por meio da combinação dos atributos name e bindingConfiguration .Bindings are linked to endpoints through the combination of the attributes name and bindingConfiguration. O binding atributo define em qual seção a associação é definida.The binding attribute defines in which section the binding is defined. O bindingConfiguration atributo define qual associação configurada dentro da seção de associação é usada.The bindingConfiguration attribute defines which configured binding within the binding section is used. Uma seção de associação pode definir várias associações configuradas.A binding section can define several configured bindings.

ExemploExample

Este é um exemplo de um arquivo de configuração do WCF.This is an example of a WCF configuration file.

<?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>

Confira tambémSee also