<> System. serviceModel<system.serviceModel>

Этот раздел конфигурации содержит все элементы конфигурации Windows Communication Foundation (WCF) ServiceModel.This configuration section contains all the Windows Communication Foundation (WCF) ServiceModel configuration elements.

<configuration> <configuration>
   <> System. serviceModel  <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>

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

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

ОтсутствуютNone

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

ЭлементElement ОписаниеDescription
<> поведения<behaviors> Данный раздел определяет две дочерние коллекции с именами endpointBehaviors и serviceBehaviors.This section defines two child collections named endpointBehaviors and serviceBehaviors. Каждая коллекция определяет элементы поведений, используемые конечными точками и службами соответственно.Each collection defines behavior elements consumed by endpoints and services respectively. Каждый элемент поведения идентифицируется по уникальному атрибуту name.Each behavior element is identified by its unique name attribute.
<привязки ><bindings> В этом разделе содержится коллекция стандартных и пользовательских привязок.This section holds a collection of standard and custom bindings. Каждая запись идентифицируется по уникальному свойству name.Each entry is identified by its unique name. Службы используют привязки, связывая их с помощью параметра name.Services use bindings by linking them using the name.
<> клиента<client> Данный раздел содержит список конечных точек, которые клиент использует для подключения к службе.This section contains a list of endpoints a client uses to connect to a service.
<comContracts ><comContracts> В данном разделе определяются контракты COM, которые разрешены для обеспечения взаимодействия WCF и COM.This section defines COM contracts enabled for WCF and COM interop.
<commonBehaviors ><commonBehaviors> Этот раздел может быть определен только в файле machine.config.This section can only be defined in the machine.config file. В нем определяются две дочерние коллекции с именами endpointBehaviors и serviceBehaviors.It defines two child collections named endpointBehaviors and serviceBehaviors. Каждая коллекция определяет элементы поведения, используемые всеми конечными точками и службами WCF на компьютере соответственно.Each collection defines behavior elements consumed by all WCF endpoints and services on the machine respectively. Если поведение определено в обоих <commonBehaviors> разделах и <behaviors> <, то поведение в разделе «behaviors >» задается предпочтением.If a behavior is defined in both <commonBehaviors> and <behaviors> sections, the behavior in the <behaviors> section is given preference.
<Диагностика ><diagnostics> В этом разделе содержатся параметры возможностей диагностики WCF.This section contains settings for the diagnostics features of WCF. Пользователь может включить или отключить трассировку, счетчики производительности и провайдер инструментария WMI, а также может добавлять специальные фильтры сообщений.The user can enable/disable tracing, performance counters, and the WMI provider, and can add custom message filters.
<расширения ><extensions> Данный раздел содержит коллекцию расширений, которые позволяют пользователю создавать определяемые пользователем привязки, поведения и другие виды расширений.This section contains a collection of extensions, which enable the user to create user-defined bindings, behaviors, and other aspects of extensions.
<Протоколмаппинг ><protocolMapping> В этом разделе определяется набор протоколов по умолчанию между схемами транспортного протокола (например, HTTP, net. TCP, net. pipe и т. д.) и привязками 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> В этом разделе определяется набор фильтров маршрутизации, которые определяют тип Windows Communication Foundation (WCF)MessageFilter , используемый при оценке входящих сообщений, а также таблицы маршрутизации, которые определяют целевые конечные точки для отправки сообщений, когда Фильтрация совпадений.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 ><serviceHostingEnvironment> Этот раздел определяет тип, который среда размещения служб создает для определенного транспорта.This section defines what type the service hosting environment instantiates for a particular transport. Если данный раздел пуст, то используется тип, заданный по умолчанию.If this section is empty, the default type is used.
<службы ><services> Раздел содержит коллекцию служб.The section contains a collection of services. Для каждой службы, определенной в сборке, данный элемент содержит элемент service, который задает параметры для данной службы.For each service defined in the assembly, this element contains a service element specifying settings for the service.
<Стандардендпоинтс ><standardEndpoints> В этом разделе определяется коллекция конечных точек, которые являются пригодными для многократного использования стандартными конечными точками.This section defines a collection of standard endpoints, which are reusable preconfigured endpoints. Значение одного или нескольких атрибутов стандартной конечной точки, обозначающих адрес, привязку или контракт, является фиксированным.A standard endpoint will have one or more of the address, binding and contract attributes set to a fixed value. Например, в конечной точке обнаружения фиксированным является контракт.For example, in the discovery endpoint the contract is fixed. По аналогии с определением пользовательских привязок можно также использовать стандартные конечные точки для расширения конечной точки службы за счет новых свойств.You can also use standard endpoints to extend service endpoint with new properties similar to defining custom bindings.
<Отслеживание ><tracking> В этом разделе определяются параметры отслеживания для службы рабочего процесса.This section defines tracking settings for a workflow service.

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

ЭлементElement ОписаниеDescription
<configuration><configuration> Корневой элемент для всех элементов конфигурации в файле конфигурации .NET.The root element for all configuration elements in a .NET configuration file.

ПримечанияRemarks

WCF не добавляет элементы в разделы конфигурации других продуктов.WCF does not add elements to the configuration sections of other products.

Службы WCF определяются в services разделе файла конфигурации.WCF services are defined in the services section of the configuration file. Сборка может содержать любое число служб.An assembly can contain any number of services. Для каждой службы используется собственный раздел конфигурации service.Each service has its own service configuration section. Этот раздел и его содержимое определяют контракт, поведение и конечные точки конкретной службы.The section and its content define the service contract, behavior, and endpoints of the particular service.

Обязательным является только атрибут name.Only a service's name attribute is required. По умолчанию имя службы описывает базовый тип CLR, который используется для реализации службы, однако можно изменить свойство ConfigurationName в классе ServiceContractAttribute, чтобы изменить требования к типу 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.

Атрибут behaviorConfiguration является необязательным.The behaviorConfiguration attribute is optional. Он указывает поведение, используемое службой.It identifies the service behavior used by a service. Поведение, которое определяется данным атрибутом, должно быть связано с поведением службы, которое определяется в области того же файла конфигурации (то есть в том же файле или в родительском файле).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).

Каждая служба предоставляет одну или несколько конечных точек, которые определяются в элементе endpoint.Each service exposes one or more endpoints defined in an endpoint element. Каждая конечная точка имеет свой адрес и привязку.Each endpoint has its own address and binding. Все привязки в файле конфигурации должны быть определены в области файла.All bindings used within the configuration file must be defined in the scope of the file.

Привязки связаны с конечными точками через сочетание атрибутов name и bindingConfiguration.Bindings are linked to endpoints through the combination of the attributes name and bindingConfiguration. Атрибут binding указывает, в каком разделе определяется привязка.The binding attribute defines in which section the binding is defined. Атрибут bindingConfiguration указывает, какая из настроенных привязок используется в разделе привязки.The bindingConfiguration attribute defines which configured binding within the binding section is used. В разделе привязки может определяться несколько настроенных привязок.A binding section can define several configured bindings.

ПримерExample

Ниже приведен пример файла конфигурации 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>

См. такжеSee also