Cómo: Agregar y quitar referencias Web

Artículo
10/22/2014

Actualización: noviembre 2007

Una referencia Web habilita un proyecto para que utilice uno o más servicios Web XML. Utilice el Agregar referencia Web (Cuadro de diálogo) para buscar servicios Web localmente, en una red de área local o en Internet.

Después de agregar una referencia Web al proyecto actual, puede llamar a cualquier método expuesto por el servicio Web. Para obtener información detallada, vea Cómo: Llamar a un servicio Web.

Para obtener información sobre cómo crear una clase de servicio Web, vea Tutorial: Generar un servicio web XML básico con ASP.NET..

Para agregar una referencia Web a un proyecto

En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nombre del proyecto al que va a agregar el servicio Web y, a continuación, haga clic en Agregar referencia Web.

Aparece el cuadro de diálogo Agregar referencia Web.

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" en el SDK de Visual Studio 2005.

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" en el SDK de Visual Studio 2005.

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

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

Nota de 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 Información general sobre las amenazas para la seguridad de las aplicaciones Web y Seguridad de acceso a código.

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 Información general sobre las amenazas para la seguridad de las aplicaciones Web y Seguridad de acceso a código.

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). Visual Web Developer 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, además de otros archivos auxiliares, como archivos de descubrimiento (.disco y .discomap), que incluyen información sobre dónde se encuentra el servicio Web.

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). Visual Web Developer 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, además de otros archivos auxiliares, como archivos de descubrimiento (.disco y .discomap), que incluyen información sobre dónde se encuentra el servicio Web.

Haga clic en Agregar referencia.

Si el sitio Web no tiene todavía una, Visual Studio creará una carpeta App_WebReferences. A continuación, creará los archivos necesarios para la clase de proxy utilizando el nombre proporcionado en el paso 5.

Quitar una referencia Web

Si su proyecto ya no necesita una referencia a un servicio Web XML, puede quitarla del mismo.

Para quitar una referencia Web de un proyecto

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

Toda la información de referencia se quita del proyecto y del almacenamiento local.

Vea también

Tareas

Cómo: Llamar a un servicio Web

Tutorial: Crear y usar un servicio Web ASP.NET en Visual Web Developer

Tutorial: Generar un servicio web XML básico con ASP.NET.

Conceptos

Información general de servicios web XML