Элемент <endpoint>

Статья
02/28/2011

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

Иерархия схемы

<system.serviceModel>
<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>

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

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

Атрибуты

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

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

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

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

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

Пример

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

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

См. также

Справочник

ServiceEndpointElement
EndpointAddress
ServiceEndpoint

Другие ресурсы

Endpoints: Addresses, Bindings, and Contracts
How to: Create a Service Endpoint in Configuration

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