Объект My.WebServices (Visual Basic)
Предоставляет свойства для создания и доступа к одному экземпляру каждой веб-службы XML, на которую ссылается текущий проект.
Заметки
Объект My.WebServices предоставляет экземпляр каждой веб-службы, на которую ссылается текущий проект. Каждый экземпляр создается по запросу. Доступ к этим веб-службам можно получить через свойства объекта My.WebServices. Имя свойства совпадает с именем веб-службы, к которой обращается свойство. Любой класс, наследуемый от SoapHttpClientProtocol — это веб-служба. Сведения о добавлении веб-служб в проект см. в разделе Доступ к веб-службам приложения (Visual Basic).
Объект My.WebServices предоставляет только веб-службы, связанные с текущим проектом. Он не обеспечивает доступа к веб-службам, объявленным в присоединенных DLL. Для доступа к веб-службе, которую предоставляет библиотека DLL, необходимо использовать полное имя веб-службы в формате ИмяDLL.ИмяВебСлужбы. Дополнительные сведения см. в разделе Доступ к веб-службам приложения (Visual Basic).
Объект и его свойства не доступны для приложений Windows.
Свойства
Каждое свойство объекта My.WebServices предоставляет доступ к экземпляру веб-службы, на которую ссылается текущий проект. Имя свойства совпадает с именем веб-службы, к которой осуществляется доступ, а тип свойства совпадает с ее типом.
Примечание
Если имеется конфликт имени, именем свойства для доступа к веб-службе является КорневоеПространствоИмен_ПространствоИмен_ИмяСлужбы.Например, рассмотрим две веб-службы с именем Service1.Если одна из этих служб находится в корневом пространстве имен WindowsApplication1 и в пространстве имен Namespace1, то доступ к этой службе нужно осуществлять при помощи My.WebServices.WindowsApplication1_Namespace1_Service1.
При первом доступе к одному из свойств объекта My.WebServices он создает новый экземпляр веб-службы и сохраняет его. Последующие обращения к этим свойствам возвращают этот экземпляр веб-службы.
Можно освободить веб-службу с помощью назначения свойству этой веб-службы значения Nothing. Установщик свойства назначает значение Nothing хранимым значениям. Если назначить свойству любое значение, отличное от Nothing, установщик сгенерирует исключение ArgumentException.
Чтобы проверить, хранит ли свойство объекта My.WebServices экземпляр веб-службы, воспользуйтесь операторами Is или IsNot. Эти операторы можно использовать для проверки того, имеет ли свойство значение Nothing.
Примечание
Обычно оператор Is или IsNot должен прочитать значение свойства для выполнения сравнения.При этом если хранимое свойство в настоящее время имеет значение Nothing, свойство создает новый экземпляр веб-службы и затем возвращает этот экземпляр.Компилятор Visual Basic обрабатывает свойства объекта My.WebServices особым образом и позволяет операторам Is или IsNot проверить состояние свойства без изменения его значения.
Задачи
Ниже перечислены примеры задач, включающих объект My.Forms.
Цель |
См. |
Вызов веб-службы в асинхронном режиме и обработка события при его завершении |
Практическое руководство. Асинхронный вызов веб-службы (Visual Basic) |
Пример
Этот пример вызывает метод FahrenheitToCelsius веб-службы XML TemperatureConverter, а затем возвращает результат.
Function ConvertFromFahrenheitToCelsius(
ByVal dFahrenheit As Double) As Double
Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function
Для работы этого примера проект должен ссылаться на веб-службу с именем Converter, а эта веб-служба должна предоставлять метод ConvertTemperature. Дополнительные сведения см. в разделе Доступ к веб-службам приложения (Visual Basic).
Этот код не работает в проекте веб-приложения.
Требования
Доступность по типу проекта
Тип проекта |
Доступность |
Приложение Windows |
Да |
Библиотека классов |
Да |
Консольное приложение |
Да |
Библиотека элементов управления Windows |
Да |
Библиотека веб-элементов управления |
Да |
Служба Windows |
Да |
Веб-узел |
Нет |