| Унаследованные члены | Описание |
|---|---|
| BeginInvoke | Метод, инициирующий асинхронный вызов Web-метода |
| CancelAsync | Метод (новый в .NET 2.0), отменяющий асинхронный вызов метода Web-сервиса XML, если вызов еще не завершен |
| EndInvoke | Метод, завершающий асинхронный вызов Web-метода |
| Invoke | Метод для синхронного вызова метода Web-сервиса |
| InvokeAsync | Метод (новый в .NET 2.0), предлагающий более предпочтительный вариант асинхронного вызова метода Web-сервиса |
| Proxy | Свойство, получающее или устанавливающее информацию агента для запроса Web-сервиса через брандмауэр |
| Timeout | Свойство, получающее или устанавливающее значение времени ожидания (в миллисекундах) для синхронных вызовов |
| Url | Свойство, получающее или устанавливающее базовое значение URL сервера для запросов |
| UserAgent | Свойство, получающее или устанавливающее значение для заголовка пользовательского агента в запросах |
Заданный по умолчанию конструктор агента "жестко" определяет значение URL удаленного Web-сервиса и запоминает это значение в наследуемом свойстве Url.
public CalculatorWebService {
this.Url = "http://localhost/CalcServicе/Service.asmx";
}
Очевидным недостатком такого подхода является то, что при переименовании или перемещении Web-сервиса XML класс агента приходится обновлять и перекомпилировать. Для построения более гибкого типа агента wsdl.exe предлагает использовать флаг /appsettingurlkey (который можно сократить до /urlkey). Если указать в командной строке этот флаг, конструктор агента будет содержать программную логику для чтения URL с помощью ключа, содержащегося в файле *.config клиента.
wsdl /out:proxy.cs /n:СаlcClient /urlkey:CalcUrl http://localhost/CalcService/Serviсе.asmx?wsdl
Если теперь проверить конструктор агента, заданный по умолчанию, вы обнаружите следующий программный код (заметьте, что если подходящий ключ не будет найден, в качестве резервного будет использоваться заданное конкретное значение URL).
public CalculatorWebService {
string urlSetting = System.Configuration.ConfigurationManager.AppSettings["CalcUrl"];
if ((urlSetting != null)) {
this.Url = urlSetting;
} else {
this.Url = "http://localhost./CalcService/Service.asmx";
}
}
Соответствующий файл app.config на стороне клиента будет примерно таким.
‹?xml version="1.0" encoding="utf-8"?›
‹configuration›
‹appSettings›
‹add key="CalcUrl" value="http://localhost/CalcService/Service.asmx" /›
‹/appSettings›
‹/configuration›
Генерируемый агент определяет также поддержку синхронного вызова Web-методов. Например, синхронный вариант метода Subtract реализуется так.
public int Subtract(int x
object[] results = this.invoke("Subtract", new object[] {x, y});
return ((int)(results[0]));
}
Обратите внимание на то, что вызывающая сторона передает два параметра, "упакованные" в массив System.Object. Используя динамическое связывание, метод Invoke передаст эти аргументы методу вычитания, размещенному по указанному адресу URL. По завершении этого (блокирующего) вызова будет обработан поступающий XML-код и результат будет возвращен вызывающей стороне в виде System.Int32 после соответствующего преобразования.
