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

Servicios Web XML, también conocido como los servicios ASMX, fueron el predecesor de Windows Communication Foundation (WCF).Puede tener acceso a los servicios Web agregando una referencia de servicio como lo haría para cualquier otro servicio WCF. Cualquier referencia que se agregue de esta manera tendrá como destino la versión más reciente de .NET Framework.

Para las aplicaciones que se crearon en una versión anterior de Visual Studio, se puede agregar todavía una referencia web que tiene como destino la versión 2.0 de .NET Framework.Para ello, siga el procedimiento que se describe en la sección siguiente.

[!NOTA]

Se debería agregar una referencia web únicamente si su aplicación tiene como destino la versión 2.0 de .NET Framework.Para agregar una referencia de servicio que tenga como destino la versión actual de .NET Framework, vea Cómo: Agregar, actualizar o quitar una referencia de servicio.

Para agregar una referencia Web a un proyecto

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 de diálogo Agregar referencia de servicio, haga clic en el botón Avanzadas.

   Aparece el cuadro de diálogo Configuración de referencia de servicio.

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

   Aparece el cuadro de diálogo Agregar referencia Web.

4. En el cuadro Dirección URL, escriba la dirección URL del servicio Web que va a utilizar.Si no sabe cuál es la dirección URL, utilice los vínculos del panel de exploración para buscar el servicio Web que desee.

   [!NOTA]

   Si está desarrollando una aplicación Web en un equipo protegido por un firewall y la aplicación va a utilizar servicios Web situados fuera de ese firewall, es preciso incluir en la dirección URL la dirección y el puerto del servidor proxy de la red.Solicite al administrador de red que le facilite esta parte de la ruta de acceso de la dirección URL.Para obtener más información, vea La configuración del proxy de este equipo no es la correcta para el descubrimiento Web..

5. En el cuadro Servicios Web disponibles en esta dirección URL, seleccione el servicio Web que va a utilizar.

6. Compruebe que el proyecto puede utilizar el servicio Web y que cualquier código externo proporcionado es de confianza.

   Nota sobre la seguridad

   Cuando abra un proyecto para editarlo y éste incluya una referencia Web, un archivo local del proxy correspondiente al servicio Web utilizado se ejecutará en un proceso de Devenv.exe iniciado por un usuario de confianza: el propio usuario.Al abrir proyectos o componentes en el entorno de desarrollo integrado (IDE), puede que se ejecute código en el equipo local.Para obtener más información, vea Code Access Security.

7. En el campo Nombre de referencia Web escriba el nombre que luego vaya a utilizar en el código para obtener acceso mediante programación al servicio Web seleccionado.

   [!NOTA]

   De forma predeterminada, a las referencias web se les asigna un espacio de nombres que corresponde al nombre del servidor.Puede cambiar este valor y escribir un nombre de espacio de nombres personalizado.Hay algunas limitaciones en cuanto a los nombres de espacio de nombres aceptados.Para obtener más información acerca de los caracteres que no se permiten en los nombres de las referencias Web, vea Agregar referencia Web (Cuadro de diálogo).Se crea un espacio de nombres basado en el nombre de la referencia web, generando una jerarquía de carpetas anidada.Dentro de la carpeta más interna se crea un archivo .wsdl que hace referencia al servicio Web, junto con otros archivos auxiliares, como archivos de descubrimiento (.disco y .discomap), que incluyen información sobre dónde se encuentra el servicio Web.

8. Haga clic en Agregar referencia.

   Si su sitio del proyecto aún no tiene una, Visual Studio crea una carpeta WebReferences.A continuación, creará los archivos necesarios para la clase de proxy usando el nombre proporcionado en el paso 7.

Vea también

Tareas

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

Referencia

Agregar referencia de servicio (Cuadro de diálogo)

Conceptos

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

Web References in Visual Studio

Otros recursos

Consuming ASMX and WCF Services Sample