<system.serviceModel>

Этот раздел конфигурации содержит все элементы конфигурации ServiceModel Для Windows Communication Foundation (WCF).

<configuration>
  <system.serviceModel>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Attributes

None

Дочерние элементы

Элемент Description
<Поведения> В этом разделе определяются две дочерние коллекции с именем endpointBehaviors и serviceBehaviors. Каждая коллекция определяет элементы поведения, используемые конечными точками и службами соответственно. Каждый элемент поведения определяется уникальным name атрибутом.
<Привязки> В этом разделе содержится коллекция стандартных и пользовательских привязок. Каждая запись определяется уникальным name. Службы используют привязки, связывая их с помощью name.
<Клиента> В этом разделе содержится список конечных точек, которые клиент использует для подключения к службе.
<comContracts> В этом разделе определены контракты COM, включенные для взаимодействия WCF и COM.
<commonBehaviors> Этот раздел можно определить только в файле machine.config. Он определяет две дочерние коллекции с именем endpointBehaviors и serviceBehaviors. Каждая коллекция определяет элементы поведения, используемые всеми конечными точками и службами WCF на компьютере соответственно. Если поведение определено в обоих <commonBehaviors><behaviors> разделах<, то поведение в >разделе поведения будет выбрано.
<диагностика> В этом разделе содержатся параметры для функций диагностики WCF. Пользователь может включить и отключить трассировку, счетчики производительности и поставщик WMI и добавлять пользовательские фильтры сообщений.
<Расширения> В этом разделе содержится коллекция расширений, которые позволяют пользователю создавать определяемые пользователем привязки, поведение и другие аспекты расширений.
<protocolMapping> В этом разделе определяется набор сопоставлений протоколов по умолчанию между схемами транспортных протоколов (например, http, net.tcp, net.pipe и т. д.) и привязками WCF.
<маршрутизация> В этом разделе определяется набор фильтров маршрутизации, определяющий тип Windows Communication Foundation (WCF),MessageFilter используемый при оценке входящих сообщений, а также таблицы маршрутизации, определяющие целевые конечные точки для отправки сообщений при совпадении фильтра.
<serviceHostingEnvironment> В этом разделе определяется тип среды размещения службы для определенного транспорта. Если этот раздел пуст, используется тип по умолчанию.
<Услуги> В разделе содержится коллекция служб. Для каждой службы, определенной в сборке, этот элемент содержит service элемент, указывающий параметры для службы.
<StandardEndpoints> В этом разделе определяется коллекция стандартных конечных точек, которые являются повторно используемыми предварительно настроенными конечными точками. Стандартная конечная точка будет иметь один или несколько атрибутов адреса, привязки и контракта, для которых задано фиксированное значение. Например, в конечной точке обнаружения контракт исправлен. Можно также использовать стандартные конечные точки для расширения конечной точки службы с новыми свойствами, аналогичными определению пользовательских привязок.
<слежение> В этом разделе определяются параметры отслеживания для службы рабочего процесса.

Родительские элементы

Элемент Description
<конфигурация> Корневой элемент для всех элементов конфигурации в файле конфигурации .NET.

Замечания

WCF не добавляет элементы в разделы конфигурации других продуктов.

Службы WCF определяются в services разделе файла конфигурации. Сборка может содержать любое количество служб. Каждая служба имеет собственный service раздел конфигурации. Раздел и его содержимое определяют контракт службы, поведение и конечные точки конкретной службы.

Требуется только атрибут службы name . По умолчанию имя службы описывает базовый тип СРЕДЫ CLR, используемый для реализации службы; Однако можно изменить свойство ConfigurationName для ServiceContractAttribute переопределения требования типа CLR.

Атрибут behaviorConfiguration необязателен. Он определяет поведение службы, используемое службой. Поведение, указанное этим атрибутом, должно ссылаться на поведение службы, определенное в области одного файла конфигурации (т. е. того же файла или родительского файла).

Каждая служба предоставляет одну или несколько конечных точек, определенных в элементе endpoint . Каждая конечная точка имеет собственный адрес и привязку. Все привязки, используемые в файле конфигурации, должны быть определены в области файла.

Привязки связаны с конечными точками с помощью сочетания атрибутов name и bindingConfiguration. Атрибут binding определяет, в каком разделе определена привязка. Атрибут bindingConfiguration определяет настроенную привязку в разделе привязки. Раздел привязки может определить несколько настроенных привязок.

Example

Это пример файла конфигурации 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>

См. также

  • Last updated on