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


элемент <endpoint>

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

<configuration>
  <system.serviceModel>
    <services>
      <service>
        <endpoint>

Синтаксис

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

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

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

Attributes

Свойство Description
address Строка, содержащая адрес конечной точки. Адрес можно указать как абсолютный или относительный адрес. Если указан относительный адрес, узел должен предоставить базовый адрес, соответствующий схеме транспорта, используемой в привязке. Если адрес не настроен, предполагается, что базовый адрес является адресом для этой конечной точки.

Значение по умолчанию — пустая строка.
behaviorConfiguration Строка, содержащая имя поведения, используемого в конечной точке.
binding Обязательный строковый атрибут, указывающий тип используемой привязки. Тип должен иметь зарегистрированный раздел конфигурации для ссылки. Тип регистрируется по имени раздела, а не по имени типа привязки.
bindingConfiguration Строка, указывающая имя привязки привязки, используемой при создании экземпляра конечной точки. Имя привязки должно находиться в области в точке определения конечной точки. Значение по умолчанию — пустая строка.

Этот атрибут используется в сочетании с binding ссылкой на определенную конфигурацию привязки в файле конфигурации. Задайте этот атрибут, если вы пытаетесь использовать пользовательскую привязку. В противном случае может быть создано исключение.
bindingName Строка, указывающая уникальное полное имя привязки для экспорта определений через WSDL. Значение по умолчанию — пустая строка.
bindingNamespace Строка, указывающая полное имя пространства имен привязки для экспорта определений через WSDL. Значение по умолчанию — пустая строка.
контракт Строка, указывающая, какой контракт представляет эту конечную точку. Сборка должна реализовать тип контракта. Если реализация службы реализует один тип контракта, это свойство может быть опущено. Значение по умолчанию — пустая строка.
endpointConfiguration Строка, указывающая имя стандартной конечной точки, заданной атрибутом kind , которая ссылается на дополнительные сведения о конфигурации этой стандартной конечной точки. То же имя должно быть определено в <standardEndpoints> разделе.
isSystemEndpoint Логическое значение, указывающее, является ли конечная точка конечной точкой инфраструктуры.
добрый Строка, указывающая тип применяемой стандартной конечной точки. Тип должен быть зарегистрирован в <extensions> разделе или в machine.config. Если ничего не указано, создается общая конечная точка службы.
listenUriMode Указывает, как транспорт обрабатывает ListenUri предоставленный для службы прослушивание. Допустимые значения:

-Явные
-Уникальный

Значение по умолчанию — явное.
Listenuri Строка, указывающая универсальный код ресурса (URI), по которому конечная точка службы прослушивает. Значение по умолчанию — пустая строка.
имя Необязательный атрибут. Строка, указывающая имя конечной точки службы. Значение по умолчанию — объединение имени привязки и имени описания контракта. Службы могут иметь несколько конечных точек, поэтому атрибут конечной точки name отличается от имени службы.

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

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

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

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

Example

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

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

См. также