<<конечная точка> клиента>

Статья
06/08/2023

Задает свойства контракта, привязки и адреса конечной точки канала, которая используется клиентами для подключения к конечным точкам службы на сервере.

<Конфигурации>
  <system.serviceModel>
    <Клиента>
      <Конечной точки>

Синтаксис

<endpoint address="String"
          behaviorConfiguration="String"
          binding="String"
          bindingConfiguration="String"
          contract="String"
          endpointConfiguration="String"
          kind="String"
          name="String">
</endpoint>

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

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

Атрибуты

Атрибут	Описание
address	Обязательный строковый атрибут. Задает адрес конечной точки. Значение по умолчанию - пустая строка. Адрес должен быть абсолютным универсальным кодом ресурса (URI).
behaviorConfiguration	Строка, содержащая имя поведения, используемое для создания экземпляра конечной точки. Имя поведения должно входить в область действия в точке определения службы. Значение по умолчанию - пустая строка.
binding	Обязательный строковый атрибут. Строка, указывающая тип привязки для использования. Чтобы на тип можно было ссылаться, он должен иметь зарегистрированный раздел конфигурации. Тип регистрируется по имени раздела, а не по имени типа привязки.
bindingConfiguration	Необязательный элемент. Строка, содержащая имя конфигурации привязки для использования при создании экземпляра конечной точки. Конфигурация привязки должна входить в область действия в точке определения конечной точки. Значением по умолчанию является пустая строка. Этот атрибут используется вместе с атрибутом `binding` для ссылки на конкретную конфигурацию привязки в файле конфигурации. Задайте этот атрибут, если выполняется попытка использовать пользовательскую привязку. В противном случае может быть создано исключение.
contract	Обязательный строковый атрибут. Строка, указывающая, к какому контракту предоставляется доступ этой конечной точкой. В сборке должен быть реализован данный тип контракта.
endpointConfiguration	Строка, указывающая имя стандартной конечной точки, задаваемой атрибутом `kind`, который ссылается на дополнительные сведения конфигурации этой конечной точки. Такое же имя должно быть задано в разделе `<standardEndpoints>`.
kind	Строка, указывающая тип применяемой стандартной конечной точки. Тип должен быть зарегистрирован в разделе `<extensions>` или в файле machine.config. Если ничего не указано, создается общая конечная точка канала.
name	Необязательный строковый атрибут. Этот атрибут уникальным образом идентифицирует конечную точку для данного контракта. Для данного типа контракта можно определить несколько клиентов. Определения должны отличаться друг от друга уникальным именем конфигурации. Если этот атрибут опущен, соответствующая конечная точка используется как конечная точка по умолчанию, связанная с заданным типом контракта. Значением по умолчанию является пустая строка. Атрибут `name` привязки используется для экспорта определения посредством языка WSDL.

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

Элемент	Описание
<Заголовки>	Коллекция заголовков адреса.
<Идентичности>	Удостоверение, обеспечивающее проверку подлинности конечной точки другими конечными точками, которые обмениваются с ней сообщениями.

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

Элемент	Описание
<Клиента>	Раздел конфигурации, определяющий список конечных точек, к которым может подключаться клиент.

Пример

Далее приведен пример конфигурации конечной точки канала.

<endpoint address="/HelloWorld/"
          bindingConfiguration="usingDefaults"
          name="MyBinding"
          binding="customBinding"
          contract="HelloWorld">
</endpoint>