Практическое руководство. Определение операций для веб-служб ASP.NET

Статья
11/05/2008

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

В конструкторе приложений и конструкторе систем можно определять операции для конечной точки поставщика веб-службы .NET. Эту задачу можно выполнить в окне "Сведения о веб-службе". Дополнительные сведения см. в разделе Общие сведения о приложениях ASP.NET на диаграммах приложений.

Совет.
Можно создать конечную точку поставщика веб-службы с готовыми подписями и типами операции, указав WSDL-файл или DISCO-файл. Затем эти операции можно изменять в окне "Сведения о веб-службе". Дополнительные сведения см. в разделе Практическое руководство. Добавление конечных точек в приложения.

Можно создать конечную точку поставщика веб-службы с готовыми подписями и типами операции, указав WSDL-файл или DISCO-файл. Затем эти операции можно изменять в окне "Сведения о веб-службе". Дополнительные сведения см. в разделе Практическое руководство. Добавление конечных точек в приложения.

Операции, определяемые для конечной точки поставщика веб-службы .NET, определяются для всех случаев использования этой конечной точки. После определения этих операций их в любое время можно изменить в окне "Сведения о веб-службе". После реализации приложения ASP.NET с конечной точкой поставщика веб-службы .NET можно изменить операции этой конечной точки в окне "Сведения о веб-службы" или в коде, который синхронизируется с этим окном. Дополнительные сведения см. в разделе Практическое руководство. Изменение операций для веб-служб ASP.NET.

Примечание.
Проект приложения ASP.NET содержит файл класса веб-службы для каждой конечной точки поставщика веб-службы в приложении. Каждый файл класса веб-службы содержит подписи операций для соответствующей конечной точки поставщика веб-службы. Каждая подпись операции вместе с комментариями представляется в файле класса веб-службы в виде метода с атрибутом WebMethod. Чтобы завершить реализацию каждой операции, можно добавить соответствующий основной код метода.

Проект приложения ASP.NET содержит файл класса веб-службы для каждой конечной точки поставщика веб-службы в приложении. Каждый файл класса веб-службы содержит подписи операций для соответствующей конечной точки поставщика веб-службы. Каждая подпись операции вместе с комментариями представляется в файле класса веб-службы в виде метода с атрибутом WebMethod. Чтобы завершить реализацию каждой операции, можно добавить соответствующий основной код метода.

Определение операции веб-службы

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

Совет.

Также можно щелкнуть конечную точку правой кнопкой мыши и выбрать пункт Определить операции.

Откроется окно "Сведения о веб-службе".
В строке операций окна "Сведения о веб-службе" выберите пункт <добавление операции> в списке Имя и задайте имя для операции.

Совет.
Также можно щелкнуть конечную точку правой кнопкой мыши и выбрать пункт Определить операции.

В той же строке в поле Тип укажите возвращаемый тип операции, если это необходимо. Если не нужно указывать тип, перейдите к шагу 7.

Примечание.
По умолчанию операция не возвращает данные, если это не указано явным образом. Представление операции, не возвращающей данные, зависит от языка, указанного для веб-службы. В языке Visual Basic возвращаемый тип операции не указывается. В языке Visual C# для операции по умолчанию используется возвращаемый тип void. Для типов интерфейса невозможна сериализация, и они вызовут ошибку при создании веб-ссылок, подключенных к веб-службе.

По умолчанию операция не возвращает данные, если это не указано явным образом. Представление операции, не возвращающей данные, зависит от языка, указанного для веб-службы. В языке Visual Basic возвращаемый тип операции не указывается. В языке Visual C# для операции по умолчанию используется возвращаемый тип void. Для типов интерфейса невозможна сериализация, и они вызовут ошибку при создании веб-ссылок, подключенных к веб-службе.

Для выбора типа начните вводить имя типа, чтобы вывести список типов.

В процессе ввода имени открывается список, содержащий доступные типы.

Совет.
Если нужный тип отсутствует в списке, используйте полное имя типа, укажите тип, определенный в другом проекте или в другой библиотеке типов, или укажите новый тип, который будет определен после реализации. Чтобы завершить указание типа, продолжайте ввод имени нужного типа.

Если нужный тип отсутствует в списке, используйте полное имя типа, укажите тип, определенный в другом проекте или в другой библиотеке типов, или укажите новый тип, который будет определен после реализации. Чтобы завершить указание типа, продолжайте ввод имени нужного типа.

Выйдите из ячейки, нажав клавишу ВВОД или щелкнув другую ячейку.

Примечание.
В результате нажатия клавиши TAB указанный тип заменяется на наиболее подходящий тип из списка.

В поле Сводка добавьте примечания к операции.

Совет.
Для добавления дополнительных сведений нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Описание. Затем можно указать дополнительные примечания к описанию WSDL, возвращаемому типу операции, если операция возвращает данные, и другие заметки. Все указанные данные описания WSDL отображаются в WSDL-файле.

Для добавления дополнительных сведений нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Описание. Затем можно указать дополнительные примечания к описанию WSDL, возвращаемому типу операции, если операция возвращает данные, и другие заметки. Все указанные данные описания WSDL отображаются в WSDL-файле.

Перед реализацией приложения ASP.NET в списке типов выводятся только типы, определенные в библиотеке ядра Microsoft (MSCorLib.dll), а также в ряде других библиотек типов, на которые существуют неявные ссылки. Однако можно ссылаться на типы, определенные в других библиотеках типов и в других проектах или на типы, которые позже планируется определить в коде или с помощью конструктора классов после реализации приложения.

Если создаются ссылочные типы, определенные в других проектах или библиотеках типов, необходимо добавить ссылки на эти проекты или библиотеки после реализации приложения. В список типов будут входить все типы, определенные во всех проектах и библиотеках типов, на которые существуют явные ссылки. Дополнительные сведения см. в разделе Практическое руководство. Добавление и удаление ссылок в Visual Studio (C#).

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

После определения операции можно определить ее параметры или другую операцию в следующей строке операции.

Определение параметров для операции веб-службы

Разверните узел операции в окне "Сведения о веб-службе".
В строке параметра под операций выберите пункт <добавить параметр> в списке Имя и задайте имя для параметра.

Совет.

Выберите для параметра уникальное имя в пределах операции.
В поле Тип укажите тип параметра, если это необходимо.
В поле Модификатор выберите порядок передачи параметра.

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

В поле Сводка добавьте примечания к параметру.

Совет.
Для добавления дополнительных сведений нажмите кнопку с многоточием (…), чтобы открыть диалоговое окно Описание.

После определения параметра можно добавить новый параметр в следующей строке параметра. Также можно определить параметр, задав его свойства в окне свойств.

См. также

Поделиться через

Практическое руководство. Определение операций для веб-служб ASP.NET

Определение операции веб-службы

Определение параметров для операции веб-службы

См. также

Задачи

Ссылки

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

Дополнительные ресурсы