Compartir a través de

Cliente de prueba de WCF (WcfTestClient.exe)

Cliente de prueba de Windows Communication Foundation (WCF) (WcfTestClient.exe) es una herramienta de GUI que permite a los usuarios introducir parámetros de prueba, enviar esa entrada al servicio y ver la respuesta que el servicio envía. Proporciona una experiencia de prueba de servicio sin problemas cuando se combina con el host de servicio WCF.

Normalmente, puede encontrar el cliente de prueba de WCF (WcfTestClient.exe) en la siguiente ubicación: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE - Community puede ser uno de "Enterprise", "Professional" o "Community" en función del nivel de Visual Studio instalado.

Escenarios para usar el cliente de prueba

En las secciones siguientes se describen los escenarios más comunes en los que puede usar el cliente de prueba de WCF para simplificar el proceso de desarrollo.

Descripción general de Visual Studio

El host de servicio WCF inicia el cliente de prueba de WCF con un solo servicio.

Después de crear un nuevo proyecto de servicio WCF y presionar F5 para iniciar el depurador, el host del servicio WCF comienza a hospedar el servicio en el proyecto. A continuación, el cliente de prueba de WCF se abre y muestra una lista de puntos de conexión de servicio definidos en el archivo de configuración. Puede probar los parámetros e invocar el servicio y repetir este proceso para probar y validar continuamente el servicio.

El host del servicio WCF inicia el cliente de prueba con varios servicios de WCF.

También puede usar el cliente de prueba de WCF para ayudar a depurar un proyecto de servicio que contenga varios servicios. Cuando se abre el cliente de prueba de WCF, itera automáticamente la lista de servicios del proyecto y los abre para realizar pruebas.

Fuera de Visual Studio

También puede invocar el cliente de prueba de WCF (WcfTestClient.exe) fuera de Visual Studio para probar un servicio arbitrario en Internet. Para localizar la herramienta, vaya a la siguiente ubicación:

C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE (donde community puede ser una de "Enterprise", "Professional" o "Community" dependiendo del nivel de Visual Studio instalado en la máquina)

Para usar la herramienta, haga doble clic en el nombre de archivo para abrirlo desde esta ubicación o iniciarlo desde una línea de comandos.

El cliente de prueba de WCF toma un número arbitrario de URI como argumentos de línea de comandos. Estos son los URI de los servicios que se pueden probar.

wcfTestClient.exe URI1 URI2 …

Una vez abierta la ventana Cliente de prueba de WCF, haga clic en Archivo->Agregar Servicio, y escriba la dirección del punto de conexión del servicio que desea abrir.

Interfaz de usuario del cliente de prueba de WCF

Puede usar el cliente de prueba de WCF con un único servicio o varios servicios.

Operaciones del servicio

En el panel izquierdo de la ventana principal del cliente de prueba de WCF se enumeran todos los servicios disponibles, junto con sus respectivos puntos de conexión y operaciones.

Al hacer doble clic en una operación, puede ver su contenido en el panel derecho dentro de una nueva pestaña con el nombre de la operación.

En el panel izquierdo también se enumeran los archivos de configuración de cliente. Haga doble clic en cualquiera de los elementos para mostrar el contenido del archivo en una nueva ventana con pestañas en el panel derecho.

Especificación de parámetros de prueba

Para ver los parámetros de prueba, haga doble clic en una operación para abrirlo en el panel derecho. Los parámetros se muestran en la vista Con formato de forma predeterminada y puede especificar valores arbitrarios para los parámetros para probar el servicio.

Para ver el XML del mensaje, haga clic en XML. Para enviarlos al servicio, haga clic en Invocar.

Para un parámetro DataSet, haga clic en el botón ... situado junto a Editar... para editarlo en una nueva ventana que muestra DataGrid. Observe la apariencia de los botones Copiar conjunto de datos y Pegar conjunto de datos . Si el esquema del objeto DataSet se desconoce en la primera edición, DataGrid está vacío. Tiene que pegar un objeto DataSet con el mismo esquema en el objeto actual de DataGrid. (Tenga en cuenta que debe copiar el esquema desde otro lugar antes de la operación de pegado). También puede copiar un objeto Dataset para su uso futuro haciendo clic en el botón Copiar conjunto de datos .

La respuesta del servicio aparece debajo de los parámetros de prueba.

Nota:

Si el valor devuelto esperado es una cadena, el resultado se mostrará como una cadena entre comillas aunque la entrada proporcionada no estuviera entre comillas.

Si especificó una operación determinada como unidireccional al crear el contrato para el servicio, no se muestra ninguna respuesta de servicio. En cuanto se pone en cola el mensaje para la entrega, aparece un cuadro de diálogo para notificarle que el mensaje se envió correctamente.

Soporte técnico de sesión

En la pestaña de una operación de servicio, la casilla de verificación Iniciar un nuevo proxy le permite activar o desactivar el soporte para sesiones. Este cuadro está desactivado de forma predeterminada.

Al escribir parámetros de prueba para una operación específica (u otra operación en el mismo punto de conexión de servicio) y haga clic en Invocar varias veces con la casilla desactivada, estas operaciones comparten un proxy y el estado del servicio se conserva en varias operaciones.

Si la casilla Iniciar un nuevo proxy está activada, se inicia un nuevo proxy para cada invocación, finaliza el escenario de sesión anterior y se restablece el estado del servicio.

Edición de la configuración del cliente

En el panel izquierdo de la ventana principal del cliente de prueba de WCF se enumeran los archivos de configuración del cliente. Haga doble clic en cualquiera de los elementos para mostrar el contenido del archivo en el panel derecho.

Edición con el Editor de configuración del servicio

Haga clic con el botón derecho en Archivo de configuración en el panel izquierdo y seleccione el menú contextual Editar con SvcConfigEditor. El Editor de configuración del servicio se inicia con el contenido de configuración del cliente. Puede editar la configuración y guardarla en la herramienta.

Después de guardar el archivo en el Editor de configuración del servicio, el cliente de prueba de WCF muestra un mensaje de advertencia para informarle de que el archivo se ha modificado fuera y le pregunta si desea volver a cargarlo.

Si selecciona Sí, el contenido de configuración de la pestaña "Client.dll.config" refleja los cambios realizados en el editor.

Si selecciona No, el contenido de configuración de la pestaña "Client.dll.config" permanece sin cambios y el contenido modificado se guarda automáticamente en el archivo de origen.

Restaurar a la configuración predeterminada

Si desea cancelar todos los cambios y restaurar a la configuración de cliente predeterminada, haga clic con el botón derecho en Archivo de configuración en el panel izquierdo y seleccione el menú contextual Restaurar a la configuración predeterminada. El valor de configuración predeterminado se carga y se restaura el contenido en la pestaña "Client.dll.config".

Validar cambios

Cuando se cargan los cambios guardados en el cliente de prueba de WCF, se comprueba la validez de la configuración en el esquema WCF. Si se encuentran errores, se muestra un cuadro de diálogo para mostrar los detalles del error.

Durante la generación de proxy, la compilación binaria o la invocación de servicio, los elementos de menú que admiten la edición (es decir, "Editar...", "Restaurar ...", etc.) están deshabilitados. La invocación del servicio también se deshabilita al cargar la configuración actualizada en el cliente de prueba de WCF.

Conservar la configuración del cliente

La pestaña Herramientas->-> contiene una opción Volver a generar siempre la configuración al iniciar servicios, que está habilitada de forma predeterminada. Esta opción especifica que cada vez que wcF Test Client carga un servicio, vuelve a generar un archivo de configuración basado en el contrato de servicio y los archivos de servicio App.config más recientes.

Si ha editado la configuración de cliente para el servicio WCF y desea usar siempre este archivo actualizado para depurar el servicio, puede desactivar la opción Regenerar . Al hacerlo, incluso cuando actualice el servicio y vuelva a abrir el cliente de prueba de WCF, el archivo Client.dll.config es el que actualizó anteriormente en lugar de uno regenerado basado en el servicio actualizado.

Sin embargo, es posible que tenga que editar el archivo de configuración para que sea coherente con el proxy regenerado. Si el proxy y el archivo de configuración regenerados no coinciden debido a un servicio actualizado, se producirán errores cuando se invoque el servicio.

Precaución

Si ha modificado el archivo de configuración de cliente y ha seleccionado reutilizarlo en el futuro, puede encontrar el archivo en la siguiente ubicación:

\Documentos y configuraciones\[User Account]\Mis documentos\Test Client Projects.

Cualquier información actualizada de credenciales almacenada en el archivo de configuración de cliente está protegida por la lista de control de acceso (ACL) de esta carpeta.

Agregar, quitar y actualizar servicios

Agregar servicio

Haga clic en Archivo->Agregar servicio para agregar un servicio al cliente de prueba de WCF. A continuación, debe escribir el URI (dirección del punto de conexión) del servicio que se va a agregar. La dirección del servicio puede ser una dirección mex o una dirección WSDL.

También puede encontrar una lista de 10 puntos de conexión de servicios agregados recientemente en el submenú Servicios recientes . Si selecciona uno de ellos, el servicio especificado se agrega al cliente de prueba de WCF.

También puede hacer clic con el botón derecho en la raíz del árbol de servicio Mis proyectos de servicio y seleccionar Agregar servicio para lograr el mismo resultado.

Durante la generación de proxy, la compilación binaria o la invocación del servicio, se deshabilitan los elementos de menú que admiten la adición de un servicio. La invocación de servicios también está deshabilitada.

Quitar servicio

Haga clic con el botón derecho en la raíz del servicio que se va a quitar y seleccione Quitar servicio para quitar un servicio del cliente de prueba de WCF.

Durante la generación de proxy, la compilación binaria o la invocación del servicio, los elementos de menú que admiten la eliminación de un servicio están deshabilitados. La invocación de servicios también está deshabilitada.

Actualizar servicio

Si se realiza un cambio en el servicio mientras se ejecuta el cliente de prueba de WCF y desea asegurarse de que la implementación del cliente de prueba de WCF para ese servicio es up-to-date, haga clic con el botón derecho en la raíz del servicio y seleccione Actualizar servicio. Tenga en cuenta que, después de actualizar, se restablece el estado del servicio.

Durante la generación de proxy, la compilación binaria o la invocación del servicio, los elementos de menú que admiten la actualización de un servicio están deshabilitados. La invocación de servicios también está deshabilitada.

Ubicación de los archivos generados por el cliente de prueba

De forma predeterminada, WCF Test Client almacena los archivos de configuración y código de cliente generados en la carpeta "%appdata%\Local\temp\Test Client Projects". Esta carpeta se elimina después de que se cierre el cliente de prueba de WCF. Si se modifica un archivo de configuración en el cliente de prueba de WCF y la opción Volver a generar siempre la configuración al iniciar los servicios está deshabilitada, el archivo modificado se copia en la carpeta "CachedConfig" en "Mis Documentos\Proyectos del Cliente de Prueba" con un archivo XML de asignación (dirección de metadatos a nombre de archivo) como índice.

También puede iniciar WCF Test Client en una línea de comandos, usar el conmutador /ProjectPath para especificar una nueva ruta deseada para almacenar archivos generados, o usar el conmutador /RestoreProjectPath para restaurar la ubicación predeterminada. La sintaxis es la siguiente:

wcfTestClient.exe /ProjectPath [desired location]

Al ejecutar este comando no se abre el cliente de prueba de WCF. Solo se cambia la ubicación de la carpeta. Puede ejecutar este comando si el cliente de prueba de WCF se está ejecutando o no. La nueva ubicación se aplica cuando se reinicia el cliente de prueba de WCF. La información de ubicación se puede guardar en el Registro o en el archivo .option de WcfTestClient.exeen la carpeta "%appdata%\Local\temp\Test Client Projects".

Características compatibles con el cliente de prueba de WCF

A continuación se muestra una lista de las características admitidas por el cliente de prueba de WCF:

  • Invocación de servicio: solicitud/respuesta y mensaje unidireccional.

  • Enlaces: todos los enlaces admitidos por Svcutil.exe.

  • Control de sesión.

  • Contrato de mensaje.

  • Serialización XML.

A continuación se muestra una lista de características no compatibles con el cliente de prueba de WCF:

Cierre del cliente de prueba de WCF

Puede cerrar el cliente de prueba de WCF de las maneras siguientes:

  • En el menú Archivo , haga clic en Salir. Como alternativa, en la ventana principal del cliente de prueba de WCF, haga clic en Cerrar. Estas dos acciones también cierran el host de autoservicio de WCF y detienen el proceso de depuración de Visual Studio si Visual Studio inició el cliente de prueba de WCF.

  • Haga clic con el botón derecho en el icono host del servicio WCF en el área de notificación y, a continuación, haga clic en Salir. Esto apaga tanto el host automático del servicio WCF como el cliente de prueba de WCF y detiene el proceso de depuración de Visual Studio.

Consulte también