Usar la herramienta de referencia de servicios web WCF

A lo largo de los años, muchos desarrolladores de Visual Studio han disfrutado de la productividad que la herramienta Agregar referencia de servicio proporcionó cuando sus proyectos de .NET Framework necesitaban acceder a los servicios web.

La herramienta de Referencia de Servicio Web WCF es una extensión de conexión de servicio de Visual Studio que le permite conectar su proyecto de .NET 5+, .NET Core o ASP.NET Core a un servicio web. Proporciona una experiencia similar a la funcionalidad Agregar referencia de servicio , que es solo para proyectos de .NET Framework. La herramienta de referencia del servicio web WCF recupera metadatos de un servicio web en la solución actual, en una ubicación de red o desde un archivo WSDL y genera un archivo de origen que contiene código proxy de cliente de Windows Communication Foundation (WCF) que la aplicación .NET puede usar para acceder al servicio web.

Importante

Solo usted debe referirse a servicios de una fuente confiable. Agregar referencias desde un origen que no es de confianza puede poner en peligro la seguridad.

Prerrequisitos

• Visual Studio 2017, versión 15.5 o posterior

Las capturas de pantalla de este artículo proceden de Visual Studio 2022.

Cómo usar la extensión

Nota:

La herramienta de referencia del servicio web WCF solo se aplica a los proyectos de .NET Core y .NET Standard de C#, incluidas las aplicaciones web de ASP.NET Core.

Con la plantilla de proyecto ASP.NET Aplicación web principal como ejemplo, este artículo le guía a través de la adición de una referencia de servicio WCF al proyecto.

1. En el Explorador de soluciones, haga doble clic en el nodo Servicios conectados del proyecto. (Para un proyecto de .NET Core o .NET Standard, haga clic con el botón derecho en el proyecto y seleccione Agregar.>Servicio conectado).

   La página Servicios conectados aparece como se muestra en la siguiente imagen:

   

2. En la página Servicios conectados , seleccione Agregar referencia de servicio.

   Se abre la página Agregar referencia de servicio .

3. Seleccione Servicio web WCF y, a continuación, elija Siguiente.

   Esto abre el asistente para agregar una nueva referencia de servicio web WCF.

   

4. Seleccione un servicio.

   a) Hay varias opciones de búsqueda de servicios disponibles:

   • Para buscar servicios definidos en la solución actual, haga clic en el botón Detectar .
   • Para buscar servicios hospedados en una dirección especificada, escriba una dirección URL de servicio en el cuadro Dirección y haga clic en el botón Ir .
   • Para seleccionar un archivo WSDL que contenga la información de metadatos del servicio web, haga clic en el botón Examinar .

   b. Seleccione el servicio en la lista de resultados de búsqueda en el cuadro Servicios . Si es necesario, escriba el espacio de nombres para el código generado en el cuadro de texto Espacio de nombres correspondiente.

   c. Haga clic en el botón Siguiente para especificar opciones de tipo de datos o opciones de cliente. Como alternativa, haga clic en el botón Finalizar para usar las opciones predeterminadas.

5. La página de opciones del tipo de datos permite refinar los valores de configuración de referencia de servicio generados:

   

   Nota:

   La opción de casilla Reutilizar tipos en ensamblados a los que se hace referencia es útil cuando los tipos de datos necesarios para la generación de código de referencia de servicio se definen en uno de los ensamblados a los que se hace referencia en el proyecto. Es importante reutilizar esos tipos de datos existentes para evitar conflictos de tipos en tiempo de compilación o problemas en tiempo de ejecución.

   Puede haber un retraso mientras se carga la información de tipo, en función del número de dependencias del proyecto y otros factores de rendimiento del sistema. El botón Finalizar se deshabilita durante la carga a menos que la casilla Reutilizar tipos en ensamblados a los que se hace referencia esté desactivada.

6. Haga clic en Finalizar cuando haya terminado.

Mientras muestra el progreso, la herramienta:

• Descarga los metadatos del servicio WCF.
• Genera el código de referencia del servicio en un archivo denominado reference.cs y lo agrega al proyecto en el nodo Servicios conectados .
• Actualiza el archivo de proyecto (.csproj) con referencias de paquete NuGet necesarias para compilar y ejecutar en la plataforma de destino.

Una vez completados estos procesos, puede crear una instancia del tipo de cliente WCF generado e invocar las operaciones de servicio.

Consulte también

• Introducción a las aplicaciones de Windows Communication Foundation
• Servicios de Windows Communication Foundation y servicios de datos WCF en Visual Studio
• Características compatibles con WCF en .NET Core

Comentarios y preguntas

Si tiene algún comentario sobre el producto, notifíelo en Developer Community mediante la herramienta Notificar un problema .

Notas de lanzamiento

• Consulte las notas de la versión para obtener información de lanzamiento actualizada, incluyendo los problemas conocidos.