My.WebServices (Objeto) (Visual Basic)
Proporciona propiedades para crear y tener acceso a una instancia única de cada servicio Web XML al que hace referencia el proyecto actual.
Comentarios
El objeto My.WebServices proporciona una instancia de cada servicio Web al que hace referencia el proyecto actual. Cada una de las instancias se crea a petición. Puede tener acceso a estos servicios Web a través de las propiedades del objeto My.WebServices. El nombre de la propiedad es igual que el nombre del servicio Web al que tiene acceso la propiedad. Cualquier clase que herede de SoapHttpClientProtocol es un servicio Web. Para obtener información sobre cómo agregar servicios Web a un proyecto, vea Acceso a los servicios Web de aplicaciones (Visual Basic).
El objeto My.WebServices expone sólo los servicios Web asociados al proyecto actual. No proporciona acceso a servicios Web declarados en archivos DLL a los que se hace referencia. Para tener acceso a un servicio Web que un archivo DLL proporciona, debe utilizar el nombre completo del servicio Web, con el formato nombreDeDll.nombreDeServicioWeb. Para obtener más información, vea Acceso a los servicios Web de aplicaciones (Visual Basic).
El objeto y sus propiedades no están disponibles para las aplicaciones Web.
Propiedades
Cada propiedad del objeto My.WebServices proporciona acceso a una instancia de un servicio Web al que hace referencia el proyecto actual. El nombre de la propiedad es el mismo que el del servicio Web al que la propiedad tiene acceso y el tipo de propiedad es igual que el tipo de servicio Web.
Nota
Si hay un conflicto de nombres, el nombre de la propiedad para tener acceso a un servicio Web es espacioDeNombresRaíz_espacioDeNombres_nombreDeServicio. Por ejemplo, considere dos servicios Web denominados Service1. Si uno de estos servicios está en el espacio de nombres raíz WindowsApplication1 y en el espacio de nombres Namespace1, obtendría acceso a ese servicio mediante My.WebServices.WindowsApplication1_Namespace1_Service1.
Cuando se tiene acceso por primera vez a una de las propiedades del objeto My.WebServices, éste crea una nueva instancia del servicio Web y la almacena. Los accesos siguientes a la propiedad devuelven esa instancia del servicio Web.
Puede desechar un servicio Web asignando Nothing a la propiedad de ese servicio Web. El establecedor de la propiedad asigna Nothing al valor almacenado. Si se asigna un valor distinto de Nothing a la propiedad, el establecedor produce una excepción ArgumentException.
Puede probar si una propiedad del objeto My.WebServices almacena una instancia del servicio Web mediante el operador Is o IsNot. Puede utilizar esos operadores para comprobar si el valor de la propiedad es Nothing.
Nota
Normalmente, el operador Is o IsNot tiene que leer el valor de la propiedad para realizar la comparación. Sin embargo, si la propiedad almacena actualmente Nothing, crea una nueva instancia del servicio Web y, a continuación, devuelve esa instancia. No obstante, el compilador de Visual Basic trata las propiedades del objeto My.WebServices de forma especial y permite al operador Is o IsNot comprobar el estado de la propiedad sin cambiar su valor.
Tareas
En la tabla siguiente se muestra un ejemplo de una tarea en la que interviene el objeto My.Forms.
Para |
Vea |
Llamar de forma asincrónica a un servicio Web y controlar un evento cuando finaliza |
Cómo: Llamar a un servicio Web de forma asincrónica (Visual Basic) |
Ejemplo
Este ejemplo llama al método FahrenheitToCelsius del servicio Web XML TemperatureConverter y devuelve el resultado.
Function ConvertFromFahrenheitToCelsius(
ByVal dFahrenheit As Double) As Double
Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function
Para que este ejemplo funcione, el proyecto debe hacer referencia a un servicio Web denominado Converter y ese servicio Web debe exponer el método ConvertTemperature. Para obtener más información, vea Acceso a los servicios Web de aplicaciones (Visual Basic).
Este código no funciona en un proyecto de aplicación Web.
Requisitos
Disponibilidad por tipo de proyecto
Tipo de proyecto |
Disponible |
Aplicación Windows |
Sí |
Biblioteca de clases |
Sí |
Aplicación de consola |
Sí |
Biblioteca de controles de Windows |
Sí |
Biblioteca de controles Web |
Sí |
Servicio de Windows |
Sí |
Sitio Web |
No |