Инструмент Soapsuds (Soapsuds.exe)

Этот раздел посвящен технологии прежних версий. Веб-службы XML и клиенты веб-служб XML должны создаваться с использованием Windows Communication Foundation.

Инструмент Soapsuds позволяет компилировать клиентские приложения, взаимодействующие с XML-веб-службами, с помощью средств удаленного взаимодействия. Программа Soapsuds.exe выполняет следующие функции.

• Создает схемы XML, описывающие службы, представленные в виде сборки среды CLR.

• Создает сборки времени выполнения для доступа к службам, описываемым схемами XML. Определение схемы может быть локальным файлом или может динамически загружаться из Интернета.

Примечание
Для .NET Framework, версия 3.5 и более поздних версий этот инструмент является устаревшим. Вместо этого задайте ссылку на библиотеку DLL удаленного объекта в проекте клиента. Если это сделано, компилятор может извлечь метаданные.

soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]

Параметры

Параметр	Описание
-domain:домен или -d:домен	Задает имя домена, используемого при соединении с сервером, требующему имя домена для проверки подлинности.
-generatecode или -gc	Генерирует код. Этот параметр эквивалентен использованию параметра -od:., где дополнительная точка указывает, что код должен быть помещен в текущий каталог.
-httpproxyname:имя или -hpn:имя	Задает имя прокси-сервера HTTP, используемого при подключении к серверу через прокси-сервер HTTP.
-httpproxyport:номер или -hpp:номер	Задает номер порта прокси-сервера HTTP, используемого при подключении к серверу через прокси-сервер HTTP.
-inputassemblyfile:файл_сборки или -ia:файл_сборки	Задает имя входного файла сборки. Инструмент импортирует все типы из сборки. При задании входной сборки не указывайте расширение ".exe" или ".dll".
-inputdirectory:каталог или -id:каталог	Указывает расположение каталогов файлов библиотеки динамической компоновки (DLL).
-inputschemafile:файл_схемы или -is:файл_схемы	Задает имя входного файла схемы XML.
-nowrappedproxy или -nowp	Не создавать прокси с оберткой. Если этот параметр не задан, инструмент по умолчанию создает прокси с оберткой.
-outputassemblyfile:файл_сборки или -oa:файл_сборки	Сохраняет выходные данные в указанный файл сборки. При создании сборки инструмент Soapsuds.exe всегда создает исходный код.
-outputdirectory:выходной_каталог или -od:выходной_каталог	Сохраняет выходные данные в указанный выходной каталог.
-outputschemafile:файл_схемы или -os:файл_схемы	Сохраняет выходные данные в указанный файл схемы XML.
-password:пароль или -p:пароль	Задает пароль, используемый при соединении с сервером, требующему проверку подлинности.
-proxynamespace:пространство_имен или -pn:пространство_имен	Задает пространство имен для кода сформированного прокси-сервера. Используйте этот параметр только для пространств имен взаимодействия.
-sdl	Создание схемы языка описания службы (SDL). Если этот параметр не указан, инструмент создает схему языка описания веб-служб (WSDL). Дополнительные сведения о языке SDL см. в разделе Описание веб-служб.
-serviceendpoint:URL-адрес или -se:URL-адрес	Задает URL-адрес или путь к URL-адресу для конечной точки службы, которая должна быть помещена в файл WSDL.
-strongnamefile:имя_файла или -sn:имя_файла	Подписывает создаваемую сборку с помощью пары ключей, находящейся в файле имя_файла. Этот файл можно создать с помощью средства для работы со строгими именами (Sn.exe).
-types: тип1,имя_сборки[,конечная_точка_службы] [;тип2,имя_сборки[,конечная_точка_службы]] [...]	Задает список входных типов.
-urltoschema:URL-адрес_схемы или -url:URL-адрес_схемы	Задает URL-адрес, из которого следует извлечь схему XML.
-username:имя_пользователя или -u:имя_пользователя	Задает имя пользователя, используемое при подключении к серверу, требующему проверку подлинности.
-wrappedproxy или -wp	Создавать прокси с оберткой. Это значение по умолчанию.
-wsdl	Создает схему WSDL. Это значение по умолчанию. Дополнительные сведения см. в разделе Описание веб-службы.

Замечания

Для доступа к XML-веб-службе из клиентского приложения выполните указанные ниже операции.

1. Загрузите схему XML для XML-веб-службы. (Параметр -urltoschema программы позволяет задать схему непосредственно по URL-адресу.) XML-веб-служба генерирует эти файлы схемы автоматически при публикации XML-веб-службы.

2. Преобразуйте схему XML в сборку времени выполнения с помощью программы Soapsuds.exe. Эта программа всегда создает исходный код при создании сборки.

3. При компиляции приложения задайте ссылку на эту сборку в клиентском приложении. Необходимо также настроить удаленное взаимодействие, чтобы ваше приложение распознавало типы из этой сборки как прокси для XML-веб-служб. Дополнительные сведения см. в разделе Общие сведения об удаленном взаимодействии .NET.

Примеры

Следующая команда загружает схему XML из URL-адреса и сохраняет ее в файл XML.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:MyService.xml

Следующая команда загружает схему из URL-адреса и создает код.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc

Следующая команда загружает схему из URL-адреса, сохраняет ее в файл и создает код.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:StockQuote.xml -gc

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

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-oa:StockQuote.dll

Следующая команда преобразует тип в схему и сохраняет ее в файл.

soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml

Следующая команда преобразует тип в схему и создает код.

soapsuds -types:MyClass.MyMethod,Service -gc

Следующая команда преобразует тип в схему, сохраняет ее в файл и создает код.

soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc 

См. также

Справочник

Инструмент языка описания веб-служб (Wsdl.exe)
Инструмент для обнаружения веб-служб (Disco.exe)

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

Общие сведения об XML-веб-службах

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

.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt