<endpoint> для <client>

Статья
02/28/2011

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

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

<system.serviceModel>
<client>
<endpoint> для <client>

Синтаксис

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

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

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

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

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

Пример

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

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

См. также

Справочник

ChannelEndpointElement
ClientSection
ChannelEndpointElementCollection
Endpoints
ChannelEndpointElement

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

WCF Client Configuration
Clients

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