Referencias web en Visual Studio

Artículo
10/22/2014

Actualización: noviembre 2007

Para simplificar el desarrollo de aplicaciones cliente de servicios web XML, Visual Studio proporciona referencias web. Las referencias Web son distintas de los componentes y referencias tradicionales; en lugar de hacer referencia a un componente o a una biblioteca de clases instalados en el equipo local, una referencia Web proporciona acceso a un recurso que está disponible mediante un protocolo de Internet, como SOAP o HTTP.

En la práctica, una referencia Web es una clase de proxy generada que representa de forma local la funcionalidad expuesta de un servicio Web XML. La clase de proxy define métodos que representan los métodos reales expuestos por un servicio Web XML. Cuando su aplicación crea una instancia de la clase de proxy, ésta puede llamar a los métodos del servicio Web XML como si el servicio Web XML fuera un componente disponible de forma local. Para obtener instrucciones sobre cómo crear una referencia Web, vea Cómo: Agregar y quitar referencias Web.

Nota:
Para hacer que los servicios web XML situados fuera de un firewall estén disponibles para el explorador web, al crear la referencia web en Visual Studio, debe especificar de forma explícita la dirección y el puerto del servidor proxy de la red.

El lenguaje de programación de una clase de proxy generada será el mismo que el del servicio Web al que ésta representa. Si crea la clase de proxy independientemente de Visual Studio (por ejemplo, con una herramienta de .NET Framework), el lenguaje de programación dependerá de la herramienta que use. Por ejemplo, si utiliza WSDL.exe, debe especificar el lenguaje de programación en la línea de comandos C# o Visual Basic. Si utiliza SProxy.exe, el lenguaje de programación es Visual C++. Para obtener más información, vea Herramienta Lenguaje de descripción de servicios Web (Wsdl.exe).

En tiempo de diseño, la clase de proxy le permite utilizar la finalización de instrucciones para los métodos de servicios Web XML. En tiempo de ejecución, una llamada a un método del objeto de servidor proxy se procesa y se codifica como un mensaje de solicitud SOAP. Si el servicio Web XML no admite SOAP, la clase de proxy utiliza HTTP GET y POST. A continuación, se envía el mensaje al servicio Web de destino para su procesamiento. Si la descripción del servicio define un mensaje de respuesta, el objeto proxy procesa este mensaje y devuelve una respuesta a su aplicación.

Administrar referencias Web

Puede cambiar el nombre de las referencias Web, modificarlas o actualizarlas si el servicio Web al que se hace referencia ha cambiado. Para obtener información detallada, vea Cómo: Cambiar el nombre de una referencia Web a un proyecto y Cómo: Actualizar una referencia Web a un proyecto.

URLBehavior (Propiedad)

Cada referencia Web del proyecto interactúa con una clase de proxy que se utiliza para obtener acceso al servicio Web. Puede utilizar la propiedad URL de referencia Web para especificar la dirección URL del servicio Web XML. En ASP.NET 1.1, una referencia web puede utilizar una dirección URL estática o dinámica. En ASP.NET 2.0 y posterior, una referencia web obtiene dinámicamente la dirección URL. Para obtener más información, vea Localizar servicios web.

Cuando en Visual Studio se crea una referencia web mediante el cuadro de diálogo Agregar referencia Web, esta propiedad se establece de manera predeterminada en la dirección URL del servicio web XML seleccionado, que es una dirección URL estática. Si se deja el comportamiento de dirección URL establecido en el valor predeterminado de estático, la clase de proxy asigna la propiedad de dirección URL a una dirección URL incluida en el código cuando se crea una instancia de la clase.

Si establece el comportamiento de la dirección URL de la referencia Web en dinámico, la aplicación obtendrá la dirección URL en tiempo de ejecución del elemento appSettings del archivo de configuración de la aplicación.

Vea también

Referencias web en Visual Studio

Administrar referencias Web

URLBehavior (Propiedad)

Vea también

Tareas

Conceptos

Referencia

Recursos adicionales