Compartir a través de

My.WebServices (objeto)

Proporciona propiedades para crear y acceder a una sola instancia de cada servicio web XML al que hace referencia el proyecto actual.

Observaciones

El My.WebServices objeto proporciona una instancia de cada servicio web al que hace referencia el proyecto actual. Cada instancia se crea bajo demanda. Puede acceder a estos servicios web a través de las propiedades del My.WebServices objeto . El nombre de la propiedad es el mismo que el nombre del servicio web al que accede 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, consulte Acceso a servicios web de aplicaciones.

El My.WebServices objeto expone solo los servicios web asociados al proyecto actual. No proporciona acceso a los servicios web declarados en archivos DLL a los que se hace referencia. Para acceder a un servicio web que proporciona un archivo DLL, debe usar el nombre completo del servicio web, con el formato DllName. WebServiceName. Para obtener más información, consulte Acceso a servicios web de aplicaciones.

El objeto y sus propiedades no están disponibles para las aplicaciones web.

Propiedades

Cada propiedad del My.WebServices objeto 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 nombre del servicio web al que accede la propiedad y el tipo de propiedad es el mismo que el tipo del servicio web.

Nota:

Si hay un conflicto de nombres, el nombre de propiedad para acceder a un servicio web es RootNamespace_Namespace_ServiceName. Por ejemplo, considere dos servicios web denominados Service1. Si uno de estos servicios está en el espacio de nombres WindowsApplication1 raíz y en el espacio de nombres Namespace1, accedería a ese servicio mediante My.WebServices.WindowsApplication1_Namespace1_Service1.

Cuando se accede por primera vez a una de las My.WebServices propiedades del objeto, se crea una nueva instancia del servicio web y se almacena. Los accesos posteriores de esa propiedad devuelven esa instancia del servicio web.

Puede eliminar un servicio web asignando Nothing a la propiedad de ese servicio web. El establecedor de propiedades asigna Nothing al valor almacenado. Si asigna algún valor distinto Nothing de a la propiedad , el establecedor produce una ArgumentException excepción.

Puede probar si una propiedad del My.WebServices objeto almacena una instancia del servicio web mediante el Is operador o IsNot . Puede usar esos operadores para comprobar si el valor de la propiedad es Nothing.

Nota:

Normalmente, el Is operador o IsNot tiene que leer el valor de la propiedad para realizar la comparación. Sin embargo, si la propiedad almacena Nothingactualmente , la propiedad crea una nueva instancia del servicio web y, a continuación, devuelve esa instancia. Sin embargo, el compilador de Visual Basic trata las propiedades del My.WebServices objeto especialmente y permite Is al operador o IsNot comprobar el estado de la propiedad sin modificar su valor.

Ejemplo

En este ejemplo se llama al FahrenheitToCelsius método del TemperatureConverter servicio web XML y se 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 Convertery ese servicio web debe exponer el ConvertTemperature método . Para obtener más información, consulte Acceso a servicios web de aplicaciones.

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

Consulte también

  • Last updated on