Elemento <endpoint> de <client>

Artículo
06/08/2023

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>