Объект My.WebServices

  • Статья

Предоставляет свойства для создания и доступа к одному экземпляру каждой веб-службы XML, на которую ссылается текущий проект.

Замечания

Объект My.WebServices предоставляет экземпляр каждой веб-службы, на которую ссылается текущий проект. Каждый экземпляр создается по запросу. Доступ к этим веб-службам можно получить через свойства объекта My.WebServices. Имя свойства совпадает с именем веб-службы, к которой обращается свойство. Любой класс, наследуемый от SoapHttpClientProtocol, является веб-службой. Сведения о добавлении веб-служб в проект см. в разделе "Доступ к веб-службам приложений".

Объект My.WebServices предоставляет только веб-службы, связанные с текущим проектом. Он не предоставляет доступ к веб-службам, объявленным в ссылках на библиотеки DLL. Чтобы получить доступ к веб-службе, которую предоставляет библиотека DLL, необходимо использовать полное имя веб-службы в формате DLLName.WebServiceName. Дополнительные сведения см. в разделе "Доступ к веб-службам приложений".

Объект и его свойства недоступны для веб-приложений.

Свойства

Каждое свойство My.WebServices объекта предоставляет доступ к экземпляру веб-службы, на которую ссылается текущий проект. Имя свойства совпадает с именем веб-службы, к которому обращается свойство, и тип свойства совпадает с типом веб-службы.

Примечание.

Если имеется конфликт имен, имя свойства для доступа к веб-службе — RootNamespace_Namespace_ServiceName. Например, рассмотрим две веб-службы с именем Service1. Если одна из этих служб находится в корневом пространстве WindowsApplication1 имен и в пространстве Namespace1имен, вы сможете получить доступ к этой службе с помощью My.WebServices.WindowsApplication1_Namespace1_Service1.

При первом доступе к одному из My.WebServices свойств объекта он создает новый экземпляр веб-службы и сохраняет его. Последующие доступы к данному свойству возвращают этот экземпляр веб-службы.

Вы можете удалить веб-службу, назначив Nothing свойству для этой веб-службы. Метод задания свойств назначает Nothing хранимое значение. При назначении какого-либо значения, отличного от Nothing свойства, метод задания создает ArgumentException исключение.

Можно проверить, хранит ли свойство My.WebServices объекта экземпляр веб-службы с помощью Is оператора или IsNot оператора. Эти операторы можно использовать для проверка, если значение свойства равноNothing.

Примечание.

Как правило, IsIsNot оператор должен считывать значение свойства для сравнения. Однако если свойство хранится Nothingв данный момент, свойство создает новый экземпляр веб-службы, а затем возвращает этот экземпляр. Однако компилятор Visual Basic обрабатывает свойства My.WebServices объекта специально и позволяет Is оператору IsNot проверка состояние свойства, не изменяя его значение.

Пример

В этом примере вызывается FahrenheitToCelsius метод TemperatureConverter веб-службы XML и возвращается результат.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

    Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function

Для работы в этом примере проект должен ссылаться на веб-службу с именем Converter, и эта веб-служба должна предоставлять ConvertTemperature метод. Дополнительные сведения см. в разделе "Доступ к веб-службам приложений".

Этот код не работает в проекте веб-приложения.

Требования

Доступность по типу проекта

Тип проекта На месте
Приложение Windows Да
Библиотека классов Да
Консольное приложение Да
Библиотека элементов управления Windows Да
Библиотека веб-элементов управления Да
Службы Windows Да
Веб-сайт No

См. также