Uso de la herramienta WCF Web Service Reference Provider

  • Artículo

Durante años, muchos desarrolladores de Visual Studio han disfrutado de la productividad que ofrecía la herramienta Agregar referencia de servicio cuando sus proyectos de .NET Framework necesitaban acceder a servicios web.

La herramienta WCF Web Service Reference es una extensión de servicio conectado de Visual Studio que le permite conectar el proyecto .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 WCF Web Service Reference 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. El archivo contiene el código de proxy de cliente e Windows Communication Foundation (WCF) y la aplicación .NET podrá usarlo para acceder al servicio web.

Importante

Solo debe hacer referencia a servicios desde un origen de confianza. Si agrega referencias desde un origen que no es de confianza podría poner en peligro la seguridad.

Requisitos previos

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

Cómo utilizar la extensión

Nota

La herramienta WCF Web Service Reference solo se aplica a proyectos de .NET Core y .NET Standard de C#, incluidas las aplicaciones web de ASP.NET Core.

En este artículo se usa la plantilla de proyecto Aplicación web de ASP.NET Core para explicar cómo agregar una referencia de servicio web de 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 secundario en el proyecto y seleccione Agregar>Servicio conectado).

    Aparece la página Servicios conectados, como se muestra en esta imagen:

    Visual Studio Connected Services tab for .NET Core

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

    Se abrirá la página Agregar referencia de servicio.

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

    Se abrirá el asistente para Agregar una referencia de servicio web de WCF nueva.

    Visual Studio Service Endpoint tab for .NET Core

  4. Seleccione un servicio.

    a. Existen varias opciones de búsqueda de servicios:

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

    b. Seleccione el servicio de 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. O bien, haga clic en el botón Finalizar para usar las opciones predeterminadas.

  5. La página Opciones de tipo de datos permite ajustar los valores de configuración de la referencia de servicio generada:

    Visual Studio Data type options tab for .NET Core

    Nota:

    La opción de la casilla Reutilizar tipos en los ensamblados a los que se hace referencia es útil cuando se definen los tipos de datos necesarios para la generación de código de referencia de servicio en uno de los ensamblados de referencia del proyecto. Es importante volver a usar esos tipos de datos existentes para evitar problemas de tiempo de ejecución o conflictos de tipo de tiempo de compilació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 está deshabilitado durante la carga, a menos que la casilla Reutilizar tipos en los 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 de servicio en un archivo con el nombre reference.cs y lo agrega al proyecto bajo el nodo Servicios conectados.
  • Actualiza el archivo de proyecto (.csproj) con las referencias del paquete NuGet necesarias para compilarlo y ejecutarlo en la plataforma de destino.

Visual Studio Progress window

Cuando se completan estos procesos, puede crear una instancia del tipo de cliente WCF generado e invocar las operaciones del servicio.

Vea también

Preguntas y comentarios

Si tiene algún comentario sobre el producto, notifíquelo en la Comunidad de desarrolladores mediante la herramienta Notificar un problema.

Notas de la versión

  • Eche un vistazo a las notas de la versión para obtener información actualizada sobre la versión, incluidos los problemas conocidos.