Методы Web Service созданных прокси-классов
Вызывает соответствующие методы веб-служб. Эти методы существуют во время выполнения, они появляются после создания сервером прокси-класса.
Примечание
Имена методов созданных прокси-классов задаются на основе методов в связанных методах веб-службы.
// Call a Web service method using the proxy class.
MyNameSpace.MyServiceProxy.MyServiceMethod(param1, param2, SucceededCallback, FailedCallback, userContext);
// Call a Web service method using a proxy class instance.
var myServiceProxy = MyNameSpace.MyService();
myServiceProxy.MyServiceMethod(param1, param2, SucceededCallback, FailedCallback, userContext);
Параметры
Параметр |
Определение |
|---|---|
param1, param2, paramn |
Параметры метода веб-службы. Можно передать все параметры, определенные в методе веб-службы. |
SucceededCallback |
Функция успешно выполненного обратного вызова. Этот параметр является необязательным. Если никакое значение не передается, используется значение defaultSucceededCallback (если определено); в противном случае вызов осуществляется автоматически и обработки результатов не происходит. При передаче значений в последовательные параметры вызова метода параметру SucceededCallback следует задать значение null. |
FailedCallback |
Функция обратного вызова, закончившаяся неудачно. Этот параметр является необязательным. Если никакое значение не передается, используется значение defaultFailedCallback (если определено); в противном случае происходит автоматический сбой вызова веб-службы. При передаче значений в последовательные параметры вызова метода параметру FailedCallback следует задать значение null. |
userContext |
Объект, содержащий пользовательский контекст. Этот параметр является необязательным. Если никакое значение не передается, используется значение defaultUserContext (если определено); в противном случае функции обратного вызова передается значение null. |
Заметки
Для вызова методов веб-службы можно воспользоваться созданным прокси-классом. Или можно создать экземпляр прокси-класса веб-службы . Затем можно задать функцию успешно выполненного обратного вызова, функцию обратного вызова, закончившуюся неудачно и, при необходимости, значение времени ожидания или контекст пользователя в качестве свойств экземпляра. Этот экземпляр прокси можно использовать для вызова методов веб-службы. В этом случае в вызове не нужно передавать функции обратного вызова или пользовательский контекст. Если данные значения передаются, они переопределят набор используемых по умолчанию значений в качестве свойств экземпляра.
Можно создать несколько экземпляров прокси-класса, каждый из которых будет иметь различные свойства. Экземпляры созданного прокси-класса обычно создаются, если нужно применить различные значения по умолчанию, например функции обратного вызова, к вызовам разных веб-служб. Используя разные функции обратного вызова, можно обрабатывать возвращаемые данные различными способами, в зависимости от потребностей приложения. Вызов методов экземпляра прокси также упрощает синтаксис вызова методов веб-служб и логику функций обратного вызова.
Пример
В следующем примере показано определение значений по умолчанию для экземпляра прокси-класса и последующее использование экземпляра для вызова метода веб-службы.
proxyInstance =
new Samples.AspNet.UsingProxyClass();
proxyInstance.set_timeout(1000);
proxyInstance.set_defaultUserContext("New context");
proxyInstance.set_defaultSucceededCallback(SucceededCallback);
proxyInstance.set_defaultFailedCallback(FailedCallback);
// Set the default color object.
proxyInstance.SetColor(color);
См. также
Ссылки
Свойство созданных прокси-классов defaultFailedCallback
Свойство созданных прокси-классов defaultSucceededCallback
Свойство созданных прокси-классов defaultUserContext