Comparteix a través de


Elemento <endpoint> de <client>

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.

<configuration>
  <system.serviceModel>
    <client>
      <endpoint>

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, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
address Atributo de cadena necesario.

Especifica la dirección del punto de conexión. 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 punto de conexión. 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 haga referencia al mismo. 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 punto de conexión. 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.
contrato Atributo de cadena necesario.

Una cadena que indica qué contrato está exponiendo este punto de conexión. El ensamblado debe implementar el tipo de contrato.
endpointConfiguration Cadena que especifica el nombre del punto de conexión estándar establecido por el atributo kind, que hace referencia a la información de configuración adicional de este punto de conexión 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 punto de conexión de canal común.
name Atributo de cadena opcional. Este atributo identifica singularmente 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 punto de conexión correspondiente se usa como el punto de conexión 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.
<identidad> Una identidad que habilita la autenticación de un punto de conexión por otros puntos de conexión que intercambian mensajes con él.

Elementos primarios

Elemento Descripción
<client> Una sección de configuración que define una lista de puntos de conexión 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>

Consulte también