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

Это диалоговое окно появляется кода вы щелкаете на командной кнопке Add или Edit в группе Clients на закладке Operations построителя XML Web Service Builder. Для получения более подробной информации смотрите Закладка Operations, построитель XML Web Service Builder.

Select control

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

Если ваш XML Web сервис возвращает простой тип данных, вы можете пожелать выбрать в качестве связываемого элемента текстовый бокс(textbox) или метку (label). Вы можете связать операцию, которая возвращает ADO.NET DataSet, который представляет из себя комплексный тип с решеткой (grid). Для объектов DataEnvironment, вы можете выбрать объект CursorAdapter и связать результаты операции с его методом CursorFill, что является типичным для операций XML Web сервиса, возвращающих ADO.NET DataSets.

Control property used to assign the Web service results

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

Для управляющего элемента TextBox обычно выбирается свойство Value; однако, если операция возвращает ADO.NET DataSet, вы можете пожелать связать его со свойством ControlSource.

Для управляющего элеммента Label, свойство Caption выбирается по умолчанию.

Для управляющего элеммента Grid и в случае, если операция возвращает ADO.NET DataSet, вы можете использовать свойство RecordSource.

Binding control to the Web service return value or parameter

Определяет источник параметра XML Web сервиса, с которым связано свойство управляющего элемента.

Установка ReturnValue выбрана по умолчанию. Однако, вы можете, кроме того, в качестве источника указать параметр операции. Это может быть полезным для операций, которые имеют параметры, посылаемые по ссылке. Это, кроме того, является иногда полезным для отображения оригинального введенного значения, например, при использовании свойства Caption управляющего элемента Label.

Client description

Определяет имя, которое вы желаете использовать для клиента. (Необязательный параметр)

Name of binding property

Указывает имя пользовательского свойства, которое вы желаете использовать как источник события для запусков вызовов операции XML Web сервиса и последовательной привязки к управляющим элементам. Эта опция по умолчанию установлена в BindMe. Однако, все пользовательские свойства и методы управляющего элемента включены в список, из которого вы можете выбрать иное, если пожелаете.

Если выбран объект CursorAdapter, то по умолчанию выбран его метод CursorFill с тем, чтобы событие вызвало создание курсора после вызова XML Web сервиса. Это полезно для операций, которые возвращают ADO.NET DataSet, так как XML Web сервис позволяет DataSet быть импортированным в объект CursorAdapter, через объект XMLAdapter, который используется методом  CursorFill объекта CursorAdapter.

Операции XML Web сервиса вызываются с использованием возможностей привязки событий Visual FoxPro. В run time, свойство, определенное Name опции свойства привязки добавляется в управляющий элемент. Это введенное свойство подается как источник события и связывается с методом InvokeClient XML Web сервиса. Когда значение связанного свойства установлено в True (.T.), срабатывает событие и вызывает метод InvokeClient, который в свою очередь вызывает операцию XML Web сервиса. После вызова операции, возвращенное значение присваивается указанному свойству управляющего элемента. Вы можете, кроме того, указать пользовательский метод вместо пользовательского свойства. Вызов этого пользовательского метода запустит событие, которое вызовет делегата InvokeClient.

Invoke at startup

Определяет, что XML Web сервис вызывается и производится привязка управляющего элемента при создании инстанции формы или класса.

Always call Web service

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

Управляющий элемент XML Web сервиса (wshandler) способен определить, что для одной и той же операции произошли множественные вызовы клиентов. Для производительности, множество клиентов используют результаты операции, когда эти клиенты вызываются одновременно, как в случае создания начальной инстанции формы или класса.

Например, предположим, что вы имеете управляющийо элемент TextBox который привязан к результатам операции своим свойством Value, а управляющий элемент Label, который связывает первый параметр введенного значения, связан с той же операцией своим свойством Caption. При создании инстанции формы или класса и при наличии вызовов обоих клиентов, обычно происходит только один вызов операции XML Web сервиса. Однако, при выборе опции "Always call Web service", вы можете указать, что все клиенты делают свои собственные вызовы к одной и той же операции. Это, кроме того, происходит, если клиент вручную (???) вызывает операцию, когда происходит создание инстанции формы или класса.

Complex Types

Отображает диалоговое окно, которое предоставляет вам возможность установить дополнительные опции, когда вы связываете операции, возвращающие комплексный тип данных, такой как ADO.NET DataSet или XMLDOMNodeList. Для получения более подробной информации смотрите XML Web сервис - диалоговое окно "Complex Types".

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