Compartir a través de


Puntos de conexión: direcciones, vinculaciones y contratos

Toda la comunicación con un servicio de Windows Communication Foundation (WCF) se produce a través de los puntos de conexión del servicio. Los puntos de conexión proporcionan a los clientes acceso a la funcionalidad que ofrece un servicio WCF.

Cada punto de conexión consta de cuatro propiedades:

  • Dirección que indica dónde se puede encontrar el punto de conexión.

  • Enlace que especifica cómo un cliente puede comunicarse con el punto de conexión.

  • Contrato que identifica las operaciones disponibles.

  • Conjunto de comportamientos que especifican los detalles de implementación local del punto de conexión.

En este tema se describe esta estructura de punto de conexión y se explica cómo se representa en el modelo de objetos WCF.

La estructura de un punto final

Cada punto de conexión consta de lo siguiente:

  • Dirección: la dirección identifica de forma única el punto de conexión y indica a los posibles consumidores del servicio donde se encuentra. Se representa en el modelo de objetos WCF por la EndpointAddress clase . Una EndpointAddress clase contiene:

    • Una propiedad Uri, que representa la dirección del servicio.

    • Propiedad Identity , que representa la identidad de seguridad del servicio y una colección de encabezados de mensaje opcionales. Los encabezados de mensaje opcionales se usan para proporcionar información de direccionamiento adicional y más detallada para identificar o interactuar con el punto de conexión.

    Para obtener más información, consulte Especificación de una dirección de punto de conexión.

  • Enlace: el enlace especifica cómo comunicarse con el extremo. Esto incluye:

    • Protocolo de transporte que se va a usar (por ejemplo, TCP o HTTP).

    • Codificación que se va a usar para los mensajes (por ejemplo, texto o binario).

    • Los requisitos de seguridad necesarios (por ejemplo, seguridad de mensajes SSL o SOAP).

    Para más información, consulte Información general sobre enlaces de WCF. Un enlace se representa en el modelo de objetos WCF mediante la clase Bindingbase abstracta . En la mayoría de los escenarios, los usuarios pueden usar uno de los enlaces proporcionados por el sistema. Para obtener más información, consulte System-Provided Bindings.

  • Contratos: el contrato describe qué funcionalidad expone el punto de conexión al cliente. Un contrato especifica lo siguiente:

    • Qué operaciones puede invocar un cliente.

    • Forma del mensaje.

    • Tipo de parámetros de entrada o datos necesarios para llamar a la operación.

    • Qué tipo de procesamiento o mensaje de respuesta puede esperar el cliente.

    Para obtener más información sobre cómo definir un contrato, consulte Diseño de contratos de servicio.

  • Comportamientos: puede usar comportamientos de punto de conexión para personalizar el comportamiento local del punto de conexión de servicio. Los comportamientos del punto de conexión lo logran participando en el proceso de creación de un entorno de ejecución de WCF. Un ejemplo del comportamiento del punto de conexión es la ListenUri propiedad, que permite especificar una dirección de escucha diferente a la dirección SOAP o Lenguaje de Descripción de Servicios Web (WSDL). Para obtener más información, consulte ClientViaBehavior.

Definición de extremos

Puede especificar el punto de conexión de un servicio de forma imperativa mediante código o mediante declaración a través de la configuración. Para obtener más información, consulte Cómo: Crear un punto de conexión de servicio en la configuración y Cómo: Crear un punto de conexión de servicio en el código.

En esta sección

En esta sección se explica el propósito de las asociaciones, los puntos de conexión y las direcciones; muestra cómo configurar una asociación y un punto de conexión; y demuestra cómo usar el comportamiento ClientVia y la propiedad ListenUri.

Direcciones
Describe cómo se abordan los puntos de conexión en WCF.

Enlaces
Describe cómo se usan los enlaces para especificar los detalles de transporte, codificación y protocolo necesarios para que los clientes y servicios se comuniquen entre sí.

Contratos
Describe cómo definen los contratos los métodos de un servicio.

Procedimiento para crear un punto de conexión de servicio en la configuración
Describe cómo crear un punto de conexión de servicio en la configuración.

Cómo: Crear un punto de conexión de servicio en código
Describe cómo crear un punto de conexión de servicio en el código.

Cómo: Usar Svcutil.exe para validar código de servicio compilado
Describe cómo detectar errores en las implementaciones y configuraciones del servicio sin hospedar el servicio mediante la Herramienta de utilidad de metadatos serviceModel (Svcutil.exe).

Consulte también