Практическое руководство. Исследование содержимого веб-служб

Обновлен: Ноябрь 2007

ASMX-файлы — это адресуемые точки входа веб-служб, создаваемых в управляемом коде. Тип получаемого при обращении к этим файлам ответа определяется порядком обращения к этим файлам по протоколу HTTP.

Справочная страница службы

При обращении через веб-обозреватель без задания необходимой строки запроса ASMX-файл возвращает автоматически генерируемую справочную страницу веб-службы. Это соответствует применению метода HTTP GET к ASMX-файлу.

Справочная страница метода службы возвращает список методов, предоставляемых веб-службой, и тех методов, к которым можно обращаться программно. Эта страница содержит ссылки на дополнительные сведения о каждом методе. Помимо всего этого, страница содержит ссылку на документ описания веб-службы.

Чтобы обратиться к справочной странице службы, выполните следующие действия:

• В адресной строке обозревателя введите основной URL-адрес веб-службы, используя следующий формат:

  https://servername/projectname/webservicename.asmx
  

  Параметр	Значение
  servername	Сервер, на котором находится веб-служба.
  projectname	Имя проекта веб-службы и дополнительные сведения о каталоге, необходимые для обращения к ASMX-файлу веб-службы.
  webservicename.asmx	Имя ASMX-файла веб-службы.

  Например, для обращения к веб-службе с именем Service1.asmx, которая является частью проекта WebService1 на локальном компьютере, можно ввести следующую строку:

  https://localhost/WebService1/Service1.asmx
  

Справочные страницы методов службы содержат дополнительные сведения о конкретных методах веб-службы.

Страницы позволяют вызывать методы с помощью протокола HTTP-POST. Однако для использования этой возможности метод веб-службы должен поддерживать протокол HTTP-POST.

В нижней части справочной страницы метода находятся образцы сообщения запроса и ответного сообщения для протоколов, поддерживаемых методом веб-службы.

Описание службы

Справочная страница службы также содержит ссылку на описание веб-службы XML, которое является формальным определением возможностей веб-службы. Описание службы — это документ, который использует грамматику языка описания веб-служб (WSDL). Описание службы определяет контракт для форматов сообщений, который должен соблюдаться клиентами при обмене сообщениями с веб-службой. Дополнительные сведения см. в разделе XML Web Service Description.

Чтобы обратиться к описанию службы, выполните следующие действия:

• В адресной строке обозревателя наберите основной URL-адрес веб-службы и задайте строку WSDL-запроса, используя следующий формат:

  https://servername/projectname/webservicename.asmx?WSDL
  

  Параметр	Значение
  servername	Сервер, на котором находится веб-служба.
  projectname	Имя проекта веб-службы и дополнительные сведения о каталоге, необходимые для обращения к ASMX-файлу веб-службы.
  webservicename.asmx	Имя ASMX-файла веб-службы.

  Например, для обращения к описанию веб-службы с именем Service1.asmx, которая является частью проекта WebService1 на локальном компьютере, можно ввести следующую строку:

  https://localhost/WebService1/Service1.asmx?WSDL
  

Обращение к веб-службам из веб-обозревателя

Обращаться к веб-службам, которые поддерживают протокол HTTP-GET, можно получить через веб-обозреватель. По умолчанию веб-службы, которые создаются в Visual Studio с помощью шаблона проекта веб-службы ASP.NET, поддерживают протоколы HTTP-GET, HTTP-POST и HTTP-SOAP. Отдельные протоколы могут поддерживать не все методы. Протоколы HTTP-GET и HTTP-POST более ограничены по поддерживаемым типам данных, чем HTTP-SOAP.

Чтобы обратиться к веб-службе через веб-обозреватель, выполните следующие действия:

• В поле адреса обозревателя наберите основной URL-адрес веб-службы с именем метода и параметрами в строке запроса, используя следующий формат:

  https://servername/projectname/webservicename.asmx/methodname?parametername0=value0&parametername1=value1&...&parameternamen=valuen
  

  Параметр	Значение
  servername	Сервер, на котором находится веб-служба.
  projectname	Имя проекта веб-службы и дополнительные сведения о каталоге, необходимые для обращения к ASMX-файлу веб-службы.
  webservicename.asmx	Имя ASMX-файла веб-службы.
  methodname	Имя веб-метода с учетом регистра.
  parametername	Имена параметров веб-метода.
  value	Закодированные в URL-адресе значения параметров веб-метода.

  Например, для обращения к методу ReturnThisString веб-службы Service1.asmx, входящей в состав проекта WebService1 на локальном компьютере, с указанием значения "This is my test string" в качестве параметра MyString можно ввести:

  https://localhost/WebService1/Service1.asmx/ReturnThisString?MyString=This+is+my+test+string
  

См. также

Основные понятия

XML Web Service Description

Другие ресурсы

Создание веб-служб в управляемом коде