Share via

<system.serviceModel>

  • Artigo

Esta secção de configuração contém todos os elementos de configuração do ServiceModel do Windows Communication Foundation (WCF).

<configuração>
  <system.serviceModel>

Syntax

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

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Nenhuma

Elementos Subordinados

Elemento Descrição
<comportamentos> Esta secção define duas coleções subordinadas com o nome endpointBehaviors e serviceBehaviors. Cada coleção define os elementos de comportamento consumidos por pontos finais e serviços, respetivamente. Cada elemento de comportamento é identificado pelo atributo exclusivo name .
<enlaces> Esta secção contém uma coleção de enlaces padrão e personalizados. Cada entrada é identificada pelo seu exclusivo name. Os serviços utilizam enlaces ao ligá-los com o name.
<cliente> Esta secção contém uma lista de pontos finais que um cliente utiliza para ligar a um serviço.
<comContracts> Esta secção define os contratos COM ativados para o interop WCF e COM.
<commonBehaviors> Esta secção só pode ser definida no ficheiro machine.config. Define duas coleções subordinadas com o nome endpointBehaviors e serviceBehaviors. Cada coleção define os elementos de comportamento consumidos por todos os pontos finais e serviços WCF no computador, respetivamente. Se um comportamento for definido em ambas as <commonBehaviors> secções, <behaviors> é dada preferência ao comportamento na <secção de> comportamentos.
<diagnósticos> Esta secção contém definições para as funcionalidades de diagnóstico do WCF. O utilizador pode ativar/desativar o rastreio, os contadores de desempenho e o fornecedor WMI e pode adicionar filtros de mensagens personalizados.
<extensões> Esta secção contém uma coleção de extensões, que permite ao utilizador criar enlaces, comportamentos e outros aspetos definidos pelo utilizador das extensões.
<protocolMapping> Esta secção define um conjunto de mapeamentos de protocolos predefinidos entre esquemas de protocolos de transporte (por exemplo, http, net.tcp, net.pipe, etc.) e enlaces WCF.
<encaminhamento> Esta secção define um conjunto de filtros de encaminhamento, que determinam o tipo de Windows Communication Foundation (WCF)MessageFilter a ser utilizado ao avaliar mensagens recebidas, bem como tabelas de encaminhamento que definem os pontos finais de destino para onde enviar mensagens quando um filtro corresponde.
<serviceHostingEnvironment> Esta secção define o tipo que o ambiente de alojamento do serviço instancia para um transporte específico. Se esta secção estiver vazia, é utilizado o tipo predefinido.
<serviços> A secção contém uma coleção de serviços. Para cada serviço definido na assemblagem, este elemento contém um service elemento que especifica definições para o serviço.
<standardEndpoints> Esta secção define uma coleção de pontos finais padrão, que são pontos finais pré-configurados reutilizáveis. Um ponto final padrão terá um ou mais dos atributos de endereço, enlace e contrato definidos como um valor fixo. Por exemplo, no ponto final de deteção, o contrato é corrigido. Também pode utilizar pontos finais padrão para expandir o ponto final de serviço com novas propriedades semelhantes à definição de enlaces personalizados.
<controlo> Esta secção define as definições de controlo de um serviço de fluxo de trabalho.

Elementos Principais

Elemento Descrição
<configuração> O elemento raiz para todos os elementos de configuração num ficheiro de configuração .NET.

Observações

O WCF não adiciona elementos às secções de configuração de outros produtos.

Os serviços WCF são definidos na services secção do ficheiro de configuração. Uma assemblagem pode conter qualquer número de serviços. Cada serviço tem a sua própria service secção de configuração. A secção e o respetivo conteúdo definem o contrato de serviço, o comportamento e os pontos finais do serviço específico.

Apenas é necessário o atributo de name um serviço. Por predefinição, o nome de um serviço descreve o tipo de CLR subjacente utilizado para implementar um serviço; no entanto, pode alterar a propriedade ConfigurationName num ServiceContractAttribute para substituir o requisito de tipo CLR.

O behaviorConfiguration atributo é opcional. Identifica o comportamento do serviço utilizado por um serviço. O comportamento especificado por este atributo tem de ligar a um comportamento de serviço definido no âmbito do mesmo ficheiro de configuração (ou seja, o mesmo ficheiro ou um ficheiro principal).

Cada serviço expõe um ou mais pontos finais definidos num endpoint elemento. Cada ponto final tem o seu próprio endereço e enlace. Todos os enlaces utilizados no ficheiro de configuração têm de ser definidos no âmbito do ficheiro.

Os enlaces estão ligados a pontos finais através da combinação dos atributos name e bindingConfiguration. O binding atributo define em que secção o enlace é definido. O bindingConfiguration atributo define que enlace configurado na secção de enlace é utilizado. Uma secção de enlace pode definir vários enlaces configurados.

Exemplo

Este é um exemplo de um ficheiro de configuração do 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>

Ver também