Partilhar via

<system.serviceModel>

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

<configuração>
   <system.serviceModel>

Sintaxe

<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 seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Nenhum

Elementos filho

Elemento Description
<Comportamentos> Esta secção define duas coleções filhas chamadas endpointBehaviors e serviceBehaviors. Cada coleção define elementos de comportamento consumidos pelos endpoints e serviços, respetivamente. Cada elemento de comportamento é identificado pelo seu atributo único name .
<Encadernações> Esta secção contém uma coleção de encadernações padrão e personalizadas. Cada entrada é identificada pelo seu único name. Os serviços usam bindings ligando-os através do name.
<cliente> Esta secção contém uma lista de endpoints que um cliente utiliza para se ligar a um serviço.
<comContracts> Esta secção define contratos COM habilitados para WCF e interoperabilidade COM.
<comumComportamentos> Esta secção só pode ser definida no ficheiro machine.config. Define duas coleções filhas chamadas endpointBehaviors e serviceBehaviors. Cada coleção define elementos de comportamento consumidos por todos os endpoints e serviços WCF na máquina, respetivamente. Se um comportamento estiver definido em ambas <commonBehaviors> as secções e <behaviors> , o comportamento na <secção de> comportamentos é dado preferência.
<Diagnóstico> Esta secção contém definições para as funcionalidades de diagnóstico do WCF. O utilizador pode ativar/desativar o rastreamento, contadores de desempenho e o fornecedor de WMI, e pode adicionar filtros de mensagens personalizados.
<Extensões> Esta secção contém uma coleção de extensões que permitem ao utilizador criar bindings, comportamentos e outros aspetos definidos pelo utilizador.
<protocolMapping> Esta secção define um conjunto de mapeamento de protocolos padrão entre esquemas de protocolo de transporte (por exemplo, http, net.tcp, net.pipe, etc.) e ligações WCF.
<Roteiro> Esta secção define um conjunto de filtros de roteamento, que determinam o tipo de Windows Communication Foundation (WCF)MessageFilter a ser usado na avaliação de mensagens recebidas, bem como tabelas de encaminhamento que definem os endpoints alvo para enviar mensagens quando um filtro coincide.
<ServiceHostingEnvironment> Esta secção define que tipo o ambiente de alojamento do serviço instancia para um determinado transporte. Se esta secção estiver vazia, é usado o tipo padrão.
<Serviços> A secção contém uma coleção de serviços. Para cada serviço definido na assembleia, este elemento contém um service elemento que especifica as definições do serviço.
<standardEndpoints> Esta secção define um conjunto de endpoints padrão, que são endpoints pré-configurados reutilizáveis. Um endpoint padrão terá um ou mais atributos de endereço, vinculação e contrato definidos com um valor fixo. Por exemplo, no endpoint de descoberta, o contrato é fixo. Também pode usar endpoints padrão para estender o endpoint de serviço com novas propriedades, semelhante à definição de bindings personalizados.
<Rastreamento> Esta secção define definições de rastreamento para um serviço de fluxo de trabalho.

Elementos Principais

Elemento Description
<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. Um conjunto pode conter qualquer número de serviços. Cada serviço tem a service sua própria secção de configuração. A secção e o seu conteúdo definem o contrato de serviço, o comportamento e os pontos finais do serviço em questão.

Apenas o atributo de name um serviço é exigido. Por defeito, o nome de um serviço descreve o tipo de CLR subjacente usado para implementar um serviço; no entanto, pode alterar a propriedade ConfigurationName em a ServiceContractAttribute para sobrepor o requisito do tipo CLR.

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

Cada serviço expõe um ou mais pontos finais definidos num endpoint elemento. Cada endpoint tem o seu próprio endereço e binding. Todas as ligações usadas dentro do ficheiro de configuração devem ser definidas no âmbito do ficheiro.

Os bindings estão ligados aos endpoints através da combinação dos atributos name e bindingConfiguration. O binding atributo define em que secção a ligação está definida. O bindingConfiguration atributo define qual a ligação configurada dentro da secção de ligação que é utilizada. Uma secção de ligação pode definir várias ligações configuradas.

Example

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

  • Last updated on