<Элемент endpoint>

Статья
06/08/2023

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

<Конфигурации>
  <system.serviceModel>
    <Услуги>
      <Службы>
        <Конечной точки>

Синтаксис

<endpoint address="String"
          behaviorConfiguration="String"
          binding="String"
          bindingConfiguration="String"
          bindingName="String"
          bindingNamespace="String"
          contract="String"
          endpointConfiguration="String"
          isSystemEndpoint="Boolean"
          kind="String"
          listenUriMode="Explicit/Unique"
          listenUri="Uri">
</endpoint>

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

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

Атрибуты

Атрибут	Описание
address	Строка, содержащая адрес конечной точки. Адрес может быть указан как абсолютный или относительный адрес. Если указан относительный адрес, от соответствующего узла ожидается предоставление базового адреса, подходящего для схемы транспорта, используемой в привязке. Если адрес не настроен, в качестве базового адреса используется адрес соответствующей конечной точки. Значением по умолчанию является пустая строка.
behaviorConfiguration	Строка, содержащая имя поведения для использования в конечной точке.
binding	Требуемый строковый атрибут, указывающий тип используемой привязки. Чтобы на тип можно было ссылаться, он должен иметь зарегистрированный раздел конфигурации. Тип регистрируется по имени раздела, а не по имени типа привязки.
bindingConfiguration	Строка, указывающая имя привязки для использования при создании экземпляра конечной точки. Имя привязки должно входить в область в точке определения конечной точки. Значение по умолчанию - пустая строка. Этот атрибут используется вместе с атрибутом `binding` для ссылки на конкретную конфигурацию привязки в файле конфигурации. Задайте этот атрибут, если выполняется попытка использовать пользовательскую привязку. В противном случае может быть создано исключение.
bindingName	Строка, указывающая уникальное полное имя привязки для экспорта определения посредством WSDL. Значением по умолчанию является пустая строка.
bindingNamespace	Строка, указывающая уникальное полное имя пространства имен привязки для экспорта определения посредством WSDL. Значением по умолчанию является пустая строка.
contract	Строка, указывающая, к какому контракту предоставляется доступ этой конечной точкой. В сборке должен быть реализован данный тип контракта. Если реализация службы реализует один тип контракта, это свойство может быть опущено. Значением по умолчанию является пустая строка.
endpointConfiguration	Строка, указывающая имя стандартной конечной точки, задаваемой атрибутом `kind`, который ссылается на дополнительные сведения конфигурации этой конечной точки. Такое же имя должно быть задано в разделе `<standardEndpoints>`.
isSystemEndpoint	Логическое значение, указывающее, является ли конечная точка конечной точкой инфраструктуры.
kind	Строка, указывающая тип применяемой стандартной конечной точки. Тип должен быть зарегистрирован в разделе `<extensions>` или файле machine.config. Если ничего не указано, создается общая конечная точка службы.
listenUriMode	Указывает способ обработки транспортом значения `ListenUri`, предоставленного для ожидания передачи данных службой. Допустимы следующие значения: -Явные -Уникальный Значение по умолчанию - Explicit.
listenUri	Строка, указывающая URI, по которому конечная точка службы ожидает передачи данных. Значением по умолчанию является пустая строка.
name	Необязательный атрибут. Строка, указывающая имя конечной точки службы. По умолчанию используется объединение имени привязки и имя описания контракта. Службы могут иметь несколько конечных точек, поэтому атрибут конечной точки `name` отличается от имени службы.

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

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

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

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

Пример

Ниже приведен пример конфигурации конечной точки службы.

<endpoint address="/HelloWorld/"
          bindingConfiguration="usingDefaults"
          bindingName="MyBinding"
          binding="customBinding"
          contract="HelloWorld">
  <headers>
    <region xmlns="http://tempuri.org/">EastCoast</region>
    <member xmlns="http://tempuri.org/">Gold</member>
  </headers>
</endpoint>

Поделиться через