Cómo: Agregar, actualizar o quitar una referencia de servicio

Una referencia de servicio habilita a un proyecto para obtener acceso a uno o más servicios de Windows Communication Foundation (WCF). Use el cuadro de diálogo Agregar referencia de servicio para buscar los servicios de WCF en la solución actual, localmente, en una red de área local, o en Internet.

Agregar una referencia de servicio

Para agregar una referencia a un servicio externo

  1. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto al que va a agregar el servicio y, a continuación, 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 para el servicio y, a continuación, haga clic en Ir para buscar el servicio. Si el servicio implementa seguridad de nombre de usuario/contraseña, es posible que le soliciten un nombre de usuario y contraseña.

    Nota

    Solamente debería agregar referencia a servicios desde una fuente de confianza.Al agregar referencias desde un origen que no es de confianza, puede poner en peligro la seguridad.

    Nota

    También, puede seleccionar la dirección URL de una lista desplegable que almacena las últimas 15 direcciones URL donde se encontraron metadatos de servicio válidos.

    Se muestra una barra de progreso mientras se realiza la búsqueda. Puede detener la búsqueda en cualquier momento haciendo clic en Detener.

  3. En la lista Servicio, expanda el nodo para el servicio que desea usar y seleccione un contrato de servicio.

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

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

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

Para agregar una referencia a un servicio en la solución actual

  1. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto al que va a agregar el servicio y, a continuación, 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 en la solución actual se agregan a la lista Servicio.

  3. En la lista Servicio, expanda el nodo para el servicio que desea usar y seleccione un contrato de servicio.

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

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

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

Actualizar una referencia de servicio

Con el tiempo, los metadatos para un servicio WCF pueden cambiar, requiriendo que la referencia de servicio esté actualizada.

Para actualizar una referencia de servicio

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

    Se muestra un cuadro de diálogo de progreso mientras la referencia se actualiza desde su ubicación original, y el cliente de servicios se vuelve a generar para reflejar cualquier cambio en los metadatos.

Quitar una referencia de servicio

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

Para quitar una referencia de servicio

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

    El cliente de servicios 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 hace referencia a la referencia de servicio se tendrá que quitar manualmente.

Vea también

Tareas

Cómo: Agregar una referencia a un servicio web XML

Referencia

Agregar referencia de servicio (Cuadro de diálogo)

Conceptos

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

Otros recursos

Consuming ASMX and WCF Services Sample