Elemento <endpoint> de <client>

Artículo
02/27/2011

Especifica el contrato, enlace y propiedades de dirección del extremo del canal, que es utilizado por clientes para conectar a los extremos de servicio en el servidor.

Jerarquía del esquema

<<system.serviceModel>>
<cliente>
Elemento <endpoint> de <client>

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
address	Atributo de cadena necesario. Especifica la dirección del extremo. El valor predeterminado es una cadena vacía. La dirección debe ser un URI absoluto.
behaviorConfiguration	Una cadena que contiene el nombre de comportamiento del comportamiento que se va a usar para crear una instancia del extremo. El nombre de comportamiento debe estar en el ámbito en el punto definido del servicio. El valor predeterminado es una cadena vacía.
binding	Atributo de cadena necesario. Una cadena que indica el tipo de enlace que se va a utilizar. El tipo debe tener una sección de configuración registrada para que se le haga referencia. El tipo está registrado por el nombre de sección, en lugar de por el nombre de tipo del enlace.
bindingConfiguration	Opcional. Una cadena que contiene el nombre de la configuración de enlace que se va a utilizar cuando se instancia el extremo. La configuración del enlace debe estar en el ámbito en el punto definido del extremo. El valor predeterminado es una cadena vacía. Este atributo se utiliza junto con binding para hacer referencia a una configuración de enlace concreta en el archivo de configuración. Establezca este atributo si está intentando utilizar un enlace personalizado. De lo contrario, puede producirse una excepción.
contract	Atributo de cadena necesario. Una cadena que indica qué contrato está exponiendo este extremo. El ensamblado debe implementar el tipo de contrato.
endpointConfiguration	Cadena que especifica el nombre del extremo estándar establecido por el atributo kind, que hace referencia a la información de configuración adicional de este extremo estándar. El mismo nombre se debe definir en la sección <standardEndpoints>.
kind	Cadena que especifica el tipo de extremo estándar aplicado. El tipo se debe registrar en la sección <extensions> o en machine.config. Si no se especifica nada, se crea un extremo de canal común.
name	Atributo de cadena opcional. Este atributo identifica de forma única un extremo para un contrato determinado. Puede definir varios clientes para un tipo de contrato determinado. Cada definición tiene que diferenciarse por un nombre de configuración unívoco. Si se omite este atributo, el extremo correspondiente se usa como el extremo predeterminado asociado al tipo de contrato especificado. El valor predeterminado es una cadena vacía. El atributo de name de un enlace se utiliza para la exportación de la definición a través de WSDL.

Elementos secundarios

Elemento	Descripción
<headers>	Una colección de encabezados de dirección.
<identity>	Una identidad que habilita la autenticación de un extremo por otros extremos que intercambian mensajes con él.

Elementos primarios

Elemento	Descripción
<cliente>	Una sección de configuración que define una lista de extremos a los que un cliente puede conectarse.

Ejemplo

Éste es un ejemplo de una configuración del extremo del canal.

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

Vea también

Referencia

ChannelEndpointElement
ClientSection
ChannelEndpointElementCollection
Endpoints
ChannelEndpointElement

Otros recursos

WCF Client Configuration
Clients

Compartir a través de