Agregar referencia Web (Cuadro de diálogo)

  • Artículo

Actualización: noviembre 2007

El cuadro de diálogo Agregar referencia Web permite buscar servicios web y agregar referencias web a los sitios web. Las referencias Web permiten usar en el código los objetos y métodos proporcionados por un servicio Web. Puede buscar servicios web en un equipo local o en servidores de la red de área local de la empresa, o bien buscar en Internet servicios web de pago.

Para abrir el cuadro de diálogo Agregar referencia Web

  • En el Explorador de soluciones, haga clic con el botón secundario del mouse (ratón) en el nombre del sitio Web y, a continuación, haga clic en Agregar referencia Web.

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

Una vez agregada una referencia web al proyecto actual, podrá utilizar en la aplicación cualquier elemento o funcionalidad que proporcione el servicio web. Para obtener más información, vea Información general sobre los servicios Web XML.

Nota de seguridad:

Cuando se abre un proyecto para editarlo y este incluye una referencia Web, un archivo del servidor proxy local del servicio Web se ejecuta en una instancia del proceso de Devenv.exe iniciado por un usuario de confianza: el propio usuario. La apertura de proyectos o componentes en el entorno de desarrollo integrado (IDE) puede permitir la ejecución del código en el equipo local. Para obtener más información, vea Seguridad de acceso del código.

Elementos de interfaz de usuario

  • Atrás

    Permite volver a la página anterior.

  • Adelante

    Permite volver a la página que se mostraba antes de hacer clic en el botón Atrás.

  • Detener

    Permite detener la carga de la página Web.

  • Actualizar

    Actualiza el contenido de la página activa en el panel de la izquierda del explorador.

  • Inicio

    Muestra la página Iniciar la búsqueda de servicios Web en el panel izquierdo del explorador.

  • Ir

    Inicia la búsqueda de servicios Web en la dirección especificada en el campo Dirección URL.

  • Dirección URL
    Muestra la dirección URL de un servicio Web que ha de utilizar la aplicación. Utilice la lista desplegable para seleccionar un servicio anteriormente usado, o bien, especifique una nueva ruta que comience por http:// o ftp://. Una dirección URL completa de referencia Web incluye un nombre de dominio, un nombre de servicio Web y el nombre de su archivo .asmx, .wsdl, .disco o archivo de descubrimiento .xsd. Por ejemplo, podría especificar:

    http://NombreDominio/NombreServicioWeb/ArchivoDescubrimiento.asmx

    En el panel Iniciar la búsqueda de servicios Web, se buscarán servicios Web en esta ruta y se mostrará la descripción de los que se encuentren.

    Nota:

    .NET Framework no detecta automáticamente los servidores proxy. Si va a desarrollar 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 que incluya 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 la dirección URL. Además, puede establecer el elemento <defaultProxy> (Elemento, Configuración de red) del archivo Machine.config o Web.config. Cualquier HttpWebRequest que no incluya una propiedad Proxy establecida en un valor específico utilizará el servidor proxy predeterminado. Para obtener más información, vea Configuring Internet Applications.

  • Iniciar la búsqueda de servicios Web
    Proporciona vínculos a listas de servicios Web disponibles. Tras hacer clic en alguno de estos vínculos, podrá seleccionar el nombre de cualquiera de los servicios Web disponibles de la lista para obtener del archivo de lenguaje de descripción de servicios Web (WSDL) la descripción de los métodos compatibles. Para obtener más información, vea Localizar servicios web y Generación de archivos WSDL para los servicios web ASP.NET.

    Este panel incluye los siguientes vínculos:

    • Servicios Web de esta solución Muestra los servicios web disponibles en la solución actual.

    • Servicios Web del equipo local   Muestra los servicios Web y documentos de descubrimiento disponibles en el equipo local.

      Para que este vínculo devuelva información, en el equipo local debe haber un servidor web en ejecución, como Internet Information Services (IIS). Para obtener más información sobre IIS, vea la Biblioteca técnica de IIS.

    • Examinar servidores UDDI de la red local   Muestra los servidores disponibles en la red de área local que proporcionan servicios web y documentos de detección que utilizan los protocolos UDDI (Universal Description, Discovery, and Integration).

      Los protocolos estándar UDDI permiten descubrir de manera rápida y mediante programación los servicios Web disponibles en una empresa determinada. Para obtener más información, vea el sitio Web de Microsoft referente a UDDI.

  • Servicios Web disponibles en esta dirección URL
    Enumera los nombres de todos los servicios Web encontrados en la dirección URL especificada. Cuando se cree una referencia web, ésta se referirá a toda la lista. Para aislar un servicio web de la lista, coloque el puntero del mouse sobre el elemento que desee de la lista. Un texto de información sobre herramientas mostrará la dirección URL del servicio elegido. Escriba la dirección URL del servicio y presione Ir. La lista debería mostrar entonces únicamente el servicio Web elegido. A partir de entonces, podrá agregar una referencia sólo para ese servicio.

  • Nombre de referencia Web
    Especifica un nombre único que se va a utilizar en el código para obtener acceso mediante programación al servicio Web seleccionado. Si el nombre escrito ya perteneciera a otro servicio Web, se le anexaría un número para hacerlo único.

    De forma predeterminada, las referencias Web se asignan a un espacio de nombres que corresponde a su nombre de servidor. Visual Web Developer crea una referencia Web basada en el nombre de referencia Web que se especifica en la carpeta App_WebReferences. En la carpeta App_WebReferences se crea un archivo .wsdl que hace referencia al servicio web, junto con archivos auxiliares, como archivos de detección (.disco y .discomap), que incluyen información sobre la ubicación del servicio web.

    Los nombres de referencia Web no pueden:

    • Contener alguno de los caracteres siguientes: / ? : \ * " < > o |

    • Contener caracteres de control Unicode.

    • Ser nombres reservados. Entre estos nombres se incluyen "CON", "AUX", "PRN", "COM1" y "LPT2".

  • Agregar referencia
    Crea una nueva referencia Web en la aplicación. Este botón se activa cuando en el campo Servicios Web disponibles en esta dirección URL aparecen uno o varios servicios Web disponibles en la dirección especificada en el campo Dirección URL. En el Explorador de soluciones bajo el nodo Referencias Web del proyecto actual, aparecerá una nueva referencia Web con el nombre indicado en el campo Nombre de referencia Web. Esta nueva referencia web hará que todos los servicios web mostrados estén disponibles en su aplicación.

    Nota:

    Para volver a generar la clase de proxy de un servicio web utilizando la copia más reciente de su archivo de descripción .wsdl, haga clic con el botón secundario del mouse en la referencia web dentro del Explorador de soluciones y haga clic en Actualizar referencia web.

Vea también

Tareas

Cómo: Agregar y quitar referencias Web

Conceptos

Hospedar objetos remotos en Internet Information Services (IIS)

Ejemplo de comunicación remota: hospedar en Internet Information Services (IIS)

Configuring Internet Applications

Referencia

La configuración del proxy de este equipo no es la correcta para el descubrimiento Web.

Otros recursos

Obtener acceso a servicios web en código administrado

Proyectos, Elementos de la interfaz de usuario

Internet Information Services SDK

Internet Information Services 5.0 Documentation

World Wide Web Consortium

WSDL Specification

UDDI.org

Microsoft UDDI Web site