Adición, actualización o eliminación de una referencia de servicio de datos de WCF

En el caso de los proyectos de .NET Framework, la referencia de servicio permite que un proyecto acceda a uno o varios Servicios de datos de WCF. Use el cuadro de diálogo Agregar referencia de servicio para buscar WCF Data Services en la solución actual, ya sea localmente, en una red de área local o en Internet.

En el caso de los proyectos de .NET Core, puede usar el nodo Servicios conectados en el Explorador de soluciones para acceder a Microsoft WCF Web Service Reference Provider, que le permite administrar las referencias de servicio de datos de Windows Communication Foundation (WCF).

Nota

Es posible que el equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en este artículo. Puede que esté usando una edición diferente de Visual Studio u otra configuración del entorno. Para obtener más información, vea Personalizar el IDE.

Prerrequisitos

Las herramientas de WCF no se instalan con la carga de trabajo de .NET. Use el Instalador de Visual Studio para modificar la instalación. En el instalador, seleccione Windows Communication Foundation en Componentes individuales. Vea Modificación de Visual Studio.

Incorporación de una referencia de servicio WCF

Incorporación de una referencia a un servicio externo (proyectos de .NET Framework)

1. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto al que quiere agregar el servicio y, después, haga clic en Agregar referencia de servicio.

   Aparecerá el cuadro de diálogo Agregar referencia de servicio.

2. En el cuadro Dirección, escriba la dirección URL del servicio y luego haga clic en Ir para buscar el servicio. Si el servicio implementa la seguridad de nombre de usuario y contraseña, es posible que se le pida un nombre de usuario y una contraseña. También puede elegir un servicio en su propia solución. Elija el botón Detectar y, después, elija Servicios en la solución.

   Nota

   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.

   También puede seleccionar la dirección URL de la lista Dirección, que almacena las 15 direcciones URL anteriores en las que se encontraron metadatos de servicio válidos.

   Cuando se realiza la búsqueda se muestra una barra de progreso. Puede detener la búsqueda en cualquier momento; para ello, haga clic en Detener.

3. En la lista Servicios, expanda el nodo del servicio que quiere usar y seleccione un conjunto de entidades.

4. En el cuadro Espacio de nombres, especifique el espacio de nombres que desea usar para la referencia.

5. Haga clic en Aceptar para agregar la referencia al proyecto.

   Se generará un cliente de servicio (proxy), y los metadatos que describen el servicio se agregarán al archivo app.config.

Incorporación de una referencia a un servicio externo (proyectos de .NET Core, incluido .NET 5 y versiones posteriores)

1. En el Explorador de soluciones, haga doble clic o pulse en el nodo Servicios conectados.

   Se abre la pestaña Configurar servicios.

2. Elija Microsoft WCF Web Service Reference Provider.

   Aparece el cuadro de diálogo Configurar WCF Web Service Reference.

   

3. En el cuadro URI, escriba la dirección URL del servicio y, después, haga clic en Ir para buscar el servicio. Si el servicio implementa la seguridad de nombre de usuario y contraseña, es posible que se le pida un nombre de usuario y una contraseña.

   Nota:

   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.

   También puede seleccionar la dirección URL de la lista URI, que almacena las 15 direcciones URL anteriores en las que se encontraron metadatos de servicio válidos.

   Cuando se realiza la búsqueda se muestra una barra de progreso. Puede detener la búsqueda en cualquier momento; para ello, haga clic en Detener.

4. En la lista Servicios, expanda el nodo del servicio que quiere usar y seleccione un conjunto de entidades.

5. En el cuadro Espacio de nombres, especifique el espacio de nombres que desea usar para la referencia.

6. Haga clic en Finalizar para agregar la referencia al proyecto.

   Se generará un cliente de servicio (proxy), y los metadatos que describen el servicio se agregarán al archivo app.config.

Incorporación de una referencia a un servicio en la solución actual (proyectos de .NET Framework)

1. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto al que quiere agregar el servicio y, después, haga clic en Agregar referencia de servicio.

   Aparecerá el cuadro de diálogo Agregar referencia de servicio.

2. Haga clic en Detectar.

   Todos los servicios (WCF Data Services y servicios WCF) de la solución actual se agregan a la lista Servicios.

3. En la lista Servicios, expanda el nodo del servicio que quiere usar y seleccione un conjunto de entidades.

4. En el cuadro Espacio de nombres, especifique el espacio de nombres que desea usar para la referencia.

5. Haga clic en Aceptar para agregar la referencia al proyecto.

   Se genera un cliente de servicio (proxy) y los metadatos que describen el servicio se agregan al archivo app.config.

Incorporación de una referencia a un servicio en la solución actual (proyectos de .NET Core)

1. En el Explorador de soluciones, haga doble clic o pulse en el nodo Servicios conectados.

   Se abre la pestaña Configurar servicios.

2. Elija Microsoft WCF Web Service Reference Provider.

   Aparece el cuadro de diálogo Configurar WCF Web Service Reference.

3. Haga clic en Detectar.

   Todos los servicios (WCF Data Services y servicios WCF) de la solución actual se agregan a la lista Servicios.

4. En la lista Servicios, expanda el nodo del servicio que quiere usar y seleccione un conjunto de entidades.

5. En el cuadro Espacio de nombres, especifique el espacio de nombres que desea usar para la referencia.

6. Haga clic en Finalizar para agregar la referencia al proyecto.

   Se genera un cliente de servicio (proxy) y los metadatos que describen el servicio se agregan al archivo app.config.

Actualización de una referencia de servicio

A veces cambia el modelo Entity Data Model de una instancia de WCF Data Services. Cuando esto sucede, debe actualizar la referencia del servicio.

Actualización de una referencia de servicio

En el caso de los proyectos de .NET Core, usa la herramienta dotnet-svcutil. Consulta dotnet-trace para obtener instrucciones de instalación.

Para proyectos de .NET Framework:

• En el Explorador de soluciones, expanda el nodo Servicios conectados, haga clic con el botón secundario en la referencia del servicio y, después, haga clic en Actualizar referencia de servicio.

  Mientras la referencia se actualiza desde su ubicación original se muestra un cuadro de diálogo de progreso y, para reflejar los cambios en los metadatos, el cliente de servicio se vuelve a generar.

Eliminación de una referencia de servicio

Si ya no se usa una referencia de servicio, puede quitarla de la solución.

Eliminación de una referencia de servicio

• En el Explorador de soluciones, haga clic con el botón secundario en la referencia de servicio y luego en Eliminar.

  El cliente de servicio se quitará de la solución y los metadatos que describen el servicio se quitarán del archivo app.config.

  Nota

  Cualquier código que se refiera a la referencia de servicio se debe quitar manualmente.

Contenido relacionado

• Servicios de Windows Communication Foundation y Servicios de datos de WCF en Visual Studio