Lección 2: agregar una referencia web

Se llama detección de servicios web al proceso por el que un cliente busca un servicio web y obtiene la descripción del servicio. El proceso de detección de servicios web en Visual Studio conlleva la interrogación de un sitio web de acuerdo con un algoritmo predeterminado. El objetivo del proceso es encontrar la descripción del servicio, que es un documento XML que utiliza el Lenguaje de descripción de servicios web (WSDL).

En la descripción del servicio, se explican los servicios disponibles y la forma de interactuar con ellos. Sin una descripción del servicio, no se puede interactuar con el servicio web mediante programación.

La aplicación debe disponer de un método para comunicarse con el servicio web y buscarlo en tiempo de ejecución. Esto se consigue agregando al proyecto una referencia del servicio web, porque se genera una clase proxy que sirve de interfaz con el servicio web y proporciona una representación local del servicio web. Para obtener más información, vea el tema sobre generación de un proxy de servicio web XML en la documentación de Visual Studio.

Para agregar una referencia web

  1. En el menú Proyecto, haga clic en Agregar referencia de servicio.

  2. En el cuadro de diálogo Agregar referencia de servicio, haga clic en el botón de opciones avanzadas.

  3. En el cuadro de diálogo Configuración de referencia de servicio, haga clic en Agregar referencia web.

  4. En el cuadro Dirección URL del cuadro de diálogo Agregar referencia web, escriba la dirección URL para obtener la descripción del servicio web del servidor de informes, por ejemplo https://localhost/reportserver/reportservice2005.asmx. A continuación, haga clic en el botón Ir para recuperar la información sobre el servicio web.

    O bien

    Si el servicio web del servidor de informes se encuentra en el equipo local, haga clic en el vínculo Servicios web del equipo local en el panel del explorador. A continuación, haga clic en el vínculo del servicio web ReportService2005 de la lista proporcionada.

  5. En el cuadro Nombre de referencia web, cambie el nombre de la referencia web a ReportService2005, que es el espacio de nombres que va a utilizar para esta referencia web.

  6. Haga clic en Agregar referencia para agregar una referencia web del servicio web de destino.

    Visual Studio descarga la descripción del servicio y genera una clase proxy que sirve de interfaz entre la aplicación y el servicio web del servidor de informes. También necesitará agregar una referencia al espacio de nombres System.Web.Services para que su referencia web funcione.

  7. En el menú Proyecto, haga clic en Agregar referencia.

  8. En la ficha .NET del cuadro de diálogo Agregar referencia, seleccione System.Web.Services y haga clic en Aceptar.

Para obtener más información, vea Acceso a la API SOAP.