Поддержка XML Web сервисов в Visual FoxPro, обеспеченная с помощью Microsoft SOAP Toolkit, предоставляет вам возможность использовать XML Web сервисы из Web. Расширения, обеспечиваемые SOAP Toolkit 3.0 предоставляют доступ к XML Web сервисам с помощью объекта Toolkit's SoapClient.

Эта высокоуровневая архитектура доступа с поздним связыванием предоставляет вам возможность непосредственно вызывать метод XML Web сервиса с помощью всего нескольких строк простого объектного кода.

Фундаментальный класс WSHandler, который включен и библиотеку классов _WS3Client.vcx в каталоге ...\Ffc, представляет собой класс XML Web сервиса, используемого для всех вызовов из Visual FoxPro XML Web сервиса.

Регистрация XML Web сервисов

Перед использованием XML Web сервиса в вашем приложении, вы должны зарегистрировать его в Visual FoxPro. Затем вы можете выбрать XML Web в Visual FoxPro Toolbox и использовать вызовы операции или метода из этого XML Web сервиса для возврата результата. При вызове XML Web сервиса, вы можете связать результаты со свойством конкретного управляющего элемента, таким как, как свойство Value управляющего элемента TextBox.

ЗамечаниеЗамечание

Вам не нужно регистрировать XML Web сервис для получения доступа к нему; однако, регистрация XML Web сервиса делает возможноым для Visual FoxPro предоставить вам IntelliSense для методов XML Web сервиса и его параметров.

Для регистрации XML Web сервиса

  1. В меню Tools щелкните на Task Pane.

  2. В панели инструментов Task Pane Manager щелкните на More Panes и, затем, щелкните на XML Web services.

  3. В панелиXML Web services щелкните на Register an XML Web Service.

  4. В диалоговом окне Visual FoxPro XML Web Services Registration впечатайте унифицированыый локатор ресурса (URL) Web Services Description Language (WSDL) XML Web сервиса и затем щелкните на Register.

Кроме того, вы можете открыть диалоговое окно Visual FoxPro XML Web Services Registration программным способом, как это показано в приведенном ниже примере:

  CopyCode imageСкопировать код
DO (_wizard) WITH "project",,"Web","IntelliSense"

Для получения более подробной информации об установках, которые вам необходимо сконфигурировать, смотрите описание Диалоговое окно "Visual FoxPro XML Web Services Registration".

Вызов XML Web сервиса

После того, как вы зарегистрируете XML Web сервис в Visual FoxPro, вы можете вызвать и связать XML Web сервис с управляющим элементов или объектов на форме. После чего вы можете обработать результаты, полученные из XML Web сервиса в вашем приложении. Вы можете вызвать и связать XML Web сервисы используя либо XML Web Service Builder или программный код. Построитель предоставляет широкие возможности связывания, освобождая вас от необходимости написания кода. Для получения более подробной информации, смотрите Построитель "XML Web Service Builder".

Описанные ниже шаги иллюстрируют, как вызвать XML Web сервис в вашей программе используя процедурный код.

Для вызова XML Web сервиса с использованием процедурного кода

  1. В меню Tools щелкните на Toolbox.

  2. В Toolbox щелкните на My XML Web сервисы.

  3. Откройте окно редактирования с указанием местонахождения вашей программы или процедурного кода, в котором вы желаете вызывать XML Web сервис.

  4. Перетащите XML Web сервис в окно редактирования.

    В окне редактирования появится процедурный код для XML Web сервиса.

Кроме того, вы можете просто напечатать в окне редактирования два символа - ws. Появится диалоговое окно Select для того, чтобы вы смогли выбрать XML Web сервис и любые дополнительные опции и вставить код для XML Web сервиса в окне редактирования. Для получения более подробной информации, смотрите Диалоговое окно "Select" (Visual FoxPro).

Вы можете использовать IntelliSense для того, чтобы увидеть достпуные методы и параметры для XML Web сервиса. Например, IntelliSense отобразит список методов, доступных в XML Web сервисе, в момент, когда вы напечаете в окне редактирования приведенные ниже строки кода:

  CopyCode imageСкопировать код
? YourXMLWebService.
ЗамечаниеЗамечание

Убедитесь в том, что заменили MyXMLWebService объектом XML Web сервиса, предоставленного в процедурном коде.

Вы можете выбрать метод и продолжать печатать, указывая параметры для метода:

  CopyCode imageСкопировать код
? MyXMLWebService.WSMethod(
ЗамечаниеЗамечание

Замените WSMethod выбранным вами методом XML Web сервиса.

IntelliSense отобразит возможные параметры и возвратит тип для этого метода.

Кроме того, вы можете перенести код для XML Web сервиса на другой компьютер, который не имеет зарегистрированного XML Web сервиса. Visual FoxPro может определить, что XML Web сервис не зарегистрирован и попросить вас зарегистрировать его. Если вы не желаете регистрировать XML Web сервис, вы можете удалить строку кода, которая содержит ссылку на WSDL, например:

  CopyCode imageСкопировать код
* __VFPWSDef__: lofoxtypes=http://mywebserver/foxws/foxtypes.wsdl

Для получения более подробной информации о доступе к XML Web сервисам с использованием вызовов высокого и низкого уровня, смотрите документацию для SOAP Toolkit 3.0.

Привязка XML Web сервисов к управляющим элементам

ВЫ можете привязать XML Web сервис к управляющему элементу или объекту на форме и присвоить результат, полученный из XML Web сервиса свойству управляющего элемента или объекту.

Для привязки XML Web сервис к управляющему элементу

  1. Создайте новую или откройте существующую форму или класс.

  2. В Tools меню щелкните Toolbox.

  3. Из My XML Web сервисы в Toolbox перетащите управляющий элемент Generic Handler или зарегистрированный XML Web сервис на форму или в класс.

    Появится XML Web Service Builder, который поможет вам привязать XML Web сервис к управляющим элементами или объектам на форме. Если построитель не появится вызовите контекстное меню щелчком по правой клавише мыши на управляющем элементе XML Web сервис и выберите Builder.

Для получения более подробной информации смотрите Построитель "XML Web Service Builder".

ЗамечаниеЗамечание

Рекомендуется, чтобы вы сохранили вновь созданную форму до перетаскивания XML Web сервиса, так как построителю нужен доступ к управляющим элементам на форме с испрользованием пути контейнера.

Смотрите также