Общие сведения о приложениях ASP.NET на диаграммах приложений

  • Статья

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

В конструкторе приложений можно определять приложения ASP.NET, которые предоставляют доступ к веб-службам, основанным на ASMX-файлах и веб-содержимому документов с помощью добавления или использования соответствующих конечных точек. Когда приложение веб-службы ASP.NET или веб-приложение ASP.NET добавляется на диаграмму приложения, определение приложения содержит конечную точку по умолчанию для веб-службы или поставщика веб-содержимого, соответственно. Однако для приложения ASP.NET можно добавлять и удалять конечные точки поставщика обоих типов. Также можно заменять конечные точки поставщика веб-службы в приложениях ASP.NET.

Дополнительные сведения см. в следующих разделах:

В следующих подразделах содержатся дополнительные сведения о приложениях ASP.NET на диаграмме приложения:

  • Определение веб-служб для приложений ASP.NET

  • Определение веб-приложений ASP.NET

  • Реализация приложений ASP.NET

  • Реализация приложений-потребителей веб-служб

Определение веб-служб для приложений ASP.NET

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

Определение, просмотр и изменение операций

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

ms181841.alert_note(ru-ru,VS.90).gifСовет.

Конструктор приложений также поддерживает работу на основе контрактов, когда можно создать конечную точку поставщика веб-службы в приложении ASP.NET со стандартными подписями и типами операций на основании существующего WSDL-файла или DISCO-файла. Дополнительные сведения см. в разделе Конечные точки веб-служб, основанные на WSDL-файлах.

Можно определить одну или несколько операций с помощью следующих элементов:

  • имя операции и тип ее возвращаемого значения (если операция возвращает значение);

  • параметры операции, включая их имена, типы (если применимо) и модификаторы, описывающие порядок передачи каждого параметра;

  • дополнительные комментарии для каждой операции или параметра.

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

Определение операций в окне "Сведения о веб-службе"

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

В следующей таблице описаны сценарии, в которых окно "Сведения о веб-службе" неправильно показывает операции веб-службы.

Сценарий

Окно "Сведения о веб-службе"

ASMX-файл содержит встроенное определение класса веб-службы.

Не отображает никакие операции.

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

-или-

Существует класс, расширяющий базовый класс, где определяются веб-методы.

Показывает только операции, соответствующие веб-методам, объявленным в классе, на который ссылается ASMX-файл.

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

Показывает только операции, сопоставленные с первой привязкой.

Дополнительные сведения см. в разделе Вопросы реконструирования в существующих решениях.

Создание ссылок на типы для операций и параметров

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

  • Оставить тип пустым или установить значение по умолчанию.

  • Выбрать тип из списка типов IntelliSense.

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

  • Создать ссылку на тип, который планируется определить позже.

Когда в окне "Сведения о веб-службе" определяются операции и параметры, для создания ссылок на типы Visual Basic и Visual C# доступна поддержка IntelliSense. После реализации приложения можно определить новые типы или переопределить существующие. Дополнительные сведения см. в разделе Практическое руководство. Определение типов операций и параметров для веб-служб ASP.NET.

Определение веб-приложений ASP.NET

В конструкторе приложений конечная точка поставщика веб-содержимого для приложения ASP.NET представляет точку подключения, по которой доступно веб-содержимое, например HTML-файлы или ASP-страницы (ASPX-файлы). Конечная точка потребителя веб-содержимого для любого приложения представляет точку подключения клиента к веб-содержимому.

Конечные точки веб-содержимого не поддерживают создание и синхронизацию кода, а также не создают записи CONFIG-файла конфигурации приложения и не синхронизируются с ними. Однако с помощью этих конечных точек можно документировать требования и задавать ограничения относительно поддержки веб-содержимого для веб-узла, размещенного на веб-сервере.

Дополнительные сведения см. в следующих разделах:

Реализация приложений ASP.NET

В ходе реализации приложения ASP.NET среда Visual Studio создает соответствующий проект, в который входят необходимые файлы. Приложения ASP.NET можно реализовывать в виде веб-проектов сервера разработки ASP.NET (на базе файловой системы) или веб-проектов служб IIS (на базе HTTP). Дополнительные сведения см. в разделах Типы приложений и прототипы для определения приложений и Практическое руководство. Выбор типа веб-узла для приложений ASP.NET.

Все проекты приложений ASP.NET содержат файл конфигурации Web.config в составе корневого проекта в обозревателе решений. Для приложения ASP.NET с конечными точками поставщика веб-службы в проект также входят ASMX-файл и файл класса веб-службы, который является файлом кода на языке программирования или файлом с выделенным кодом, для каждой конечной точки поставщика веб-службы.

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

ms181841.alert_note(ru-ru,VS.90).gifПримечание.

Все определения на языке WSDL, заданные в комментариях к операции, также отображаются в WSDL-файле. Кроме того, можно настроить параметры создания WSDL-файла. Дополнительные сведения см. в разделе Создание WSDL-файлов для веб-служб ASP.NET.

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

Динамическое назначение портов для веб-приложений ASP.NET

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

ms181841.alert_note(ru-ru,VS.90).gifСовет.

Номер порта можно просмотреть в окне свойств, щелкнув правой кнопкой мыши проект приложения ASP.NET в обозревателе решений.

Например, для приложений ASP.NET на базе файловой системы назначаются новые номера портов в любой из следующих ситуаций.

  • Когда открывается решение, содержащие эти типы приложений ASP.NET, а также реализованные приложения-потребители веб-службы со ссылками на веб-службы, доступные в этих приложениях ASP.NET.

  • Когда отладчик Visual Studio впервые используется в решении, содержащем эти типы приложений ASP.NET.

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

ms181841.alert_note(ru-ru,VS.90).gifПримечание.

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

Для управления назначением номеров портов можно запретить в проекте приложения ASP.NET на базе файловой системы использование динамических портов.

ms181841.alert_note(ru-ru,VS.90).gifПримечание.

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

Дополнительные сведения см. в следующих разделах:

Реализация приложений-потребителей веб-служб

Во время реализации приложения с одной или несколькими конечными точками потребителя веб-службы для каждой конечной точки потребителя веб-службы создается веб-ссылка, если доступен WSDL-файл, используемый для создания веб-ссылки. Этот WSDL-файл указывается в свойстве расположения WSDL для конечной точки потребителя веб-службы. Когда создается веб-ссылка, в файле конфигурации приложения-потребителя также создается URL-адрес веб-службы.

ms181841.alert_note(ru-ru,VS.90).gifПримечание.

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

Веб-служба обрабатывает создание прокси-класса клиента веб-службы и прокси-типов для вызова операций веб-службы и обработки передачи сообщений SOAP. Также можно выполнить реконструирование и визуализацию пользовательских прокси-классов клиента веб-службы, включая пользовательские прокси-классы и веб-ссылки, определенные в библиотеках классов в виде конечных точек потребителя веб-службы. Дополнительные сведения см. в разделах Creating an XML Web Service Proxy и Вопросы использования пользовательских прокси-классов клиента веб-службы.

ms181841.alert_note(ru-ru,VS.90).gifПримечание.

Кроме того, после реализации можно включить XML-документацию для приложения Windows или приложения-потребителя веб-службы, чтобы включать в XML-файл комментарии для операций. Этот файл создается после построения проекта приложения. Чтобы создать XML-файл, необходимо включить XML-документацию для проекта Windows. Сведения о проектах Windows на Visual Basic см. в разделе Практическое руководство. Создание документации проекта в формате XML. Сведения о проектах Windows на Visual C# см. в разделах Практическое руководство. Установка свойств построения (C#) и Страница "Построение" в конструкторе проектов (C#).

См. также

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

Определение приложений ASP.NET на диаграммах приложений