Пакет SDK для .NET Framework включает программу Wsdl.exe для работы с языком WSDL, которая позволяет создать прокси-класс веб-службы для использования в среде разработки .NET Framework. Программа WSDL представляет самый распространенный способ создания прокси-класса клиента на языках, поддерживающих веб-службы (в настоящее время это C# и Microsoft Visual Basic).

Добавление класса-посредника в проект с помощью Wsdl.exe

1. Запустите программу Wsdl.exe из командной строки, чтобы создать класс-посредник, указав (по крайней мере) URL-адрес для веб-службы сервера отчетов.
   Например, следующая инструкция командной строки указывает URL-адрес для конечной точки управления в веб-службе сервера отчетов:
   
   wsdl /language:CS /n:"Microsoft.SqlServer.ReportingServices2005" http://<Server Name>/reportserver/reportservice2005.asmx?wsdl

   Программа WSDL принимает ряд аргументов командной строки для создания прокси-класса. В предыдущем примере задается язык C# и рекомендуемое пространство имен для использования в прокси-классе (чтобы предотвратить конфликт имен в случае использования нескольких конечных точек веб-службы), а затем создается файл кода C# с именем ReportingService2005.cs. Если в примере указать язык Visual Basic, будет создан прокси-файл с именем ReportingService2005.vb. Этот файл создается в каталоге, из которого запущена команда.
   
2. Скомпилируйте класс-посредник в файл сборки (с расширением DLL) и создайте в проекте ссылку на сборку или добавьте класс в качестве элемента проекта.
   

   Примечание.
   Если класс-посредник добавляется в проект вручную, необходимо добавить ссылку на библиотеку System.Web.Services.dll. Если прокси-класс добавляется с помощью веб-ссылки в Visual Studio .NET, то ссылка создается автоматически. Дополнительные сведения см. в подразделе «Добавление прокси-класса с помощью веб- ссылки в Visual Studio» далее в этом разделе.

   После добавления класса-посредника в качестве элемента проекта в обозревателе решений появляется соответствующий файл.
   
3. Чтобы вызвать службу программным образом, создайте экземпляр класса-посредника.
   В следующем примере кода показан синтаксис для создания экземпляра класса-посредника ReportingService2005 в проекте.
   

Dim service As New ReportingService2005()

ReportingService2005 service = new ReportingService2005();

Дополнительные сведения о программе Wsdl.exe, включая полный синтаксис, см. в разделе «Программа WSDL» документации по пакету SDK для .NET Framework. Полное описание прокси для веб-служб см. в разделе «Создание прокси для веб-служб с поддержкой XML» документации по пакету SDK для .NET Framework.

Примечание.
Для обеспечения обратной совместимости по-прежнему доступна веб-служба, входящая в состав служб Microsoft SQL Server 2000 Reporting Services. Она доступна по URL-адресу http://myserver/reportserver/reportservice.asmx?wsdl.

Веб-ссылка позволяет проекту использовать одну или несколько веб-служб. Среда Visual Studio дает пользователям возможность добавлять в проекты ссылки на веб-службы, выполняя несколько простых действий.

Добавление веб--ссылки в проект

1. В окне Обозреватель решений выберите проект, который будет использовать веб-службу.
   
2. В меню Project выберите пункт Add Web Reference.
   Откроется диалоговое окно Добавление веб-ссылки.
   
3. В поле URL-адрес введите полный путь к веб-службе сервера отчетов.
   Упрощенный URL-адрес конечной точки выполнения отчета для веб-службы сервера отчетов может иметь следующий вид:
   
   http://<Server Name>/reportserver/reportexecution2005.asmx

   URL-адрес содержит домен, в котором развернута веб-служба сервера отчетов, имя папки, содержащей службу, и имя файла обнаружения для службы. Полное описание различных элементов URL-адреса см. в разделе Доступ к API-интерфейсу SOAP.
   Описание методов и свойств, предоставляемых веб-службой, появляется слева в области обозревателя.
   

   Примечание.
   Дополнительные сведения об элементах, связанных с веб-службой сервера отчетов, см. в разделе Методы веб-службы сервера отчетов.

4. Убедитесь, что проект может использовать веб-службу сервера отчетов, а также в наличии необходимых разрешений для доступа к серверу отчетов.
   
5. В поле Имя веб-ссылки введите имя, которое будет использоваться в коде для программного доступа к веб-службе сервера отчетов.
   
6. Нажмите кнопку Добавить ссылку, чтобы создать в приложении ссылку на веб-службу.
   Новая ссылка появится в окне Обозреватель решений в узле «Веб-ссылки» для активного проекта и будет иметь имя, указанное в поле Имя веб-ссылки.
   
7. В окне Обозреватель решений разверните папку «Веб-ссылки», чтобы показать пространство имен для классов веб-ссылки, которые доступны элементам проекта.
   После добавления веб-ссылки в проект соответствующие файлы отображаются в папке, входящей в папку «Веб-ссылки» окна Обозреватель решений.
   

После добавления веб-ссылки используйте следующий код для создания экземпляра класса-посредника:

Dim rs As New myNamespace.myReferenceName.ReportExecutionService()rs.Url = "http://<Server Name>/reportserver/reportexecution2005.asmx?wsdl"rs.Credentials = System.Net.CredentialCache.DefaultCredentials

myNamespace.myReferenceName.ReportExecutionService rs = new myNamespace.myReferenceName.ReportExecutionService();rs.Url = "http://<Server Name>/reportserver/reportexecution2005.asmx?wsdl"rs.Credentials = System.Net.CredentialCache.DefaultCredentials

Import myNamespace.myReferenceName

using myNamespace.myReferenceName;

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

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

Справка и информация