Методы 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); 



Показ: