Вопросы реконструирования в существующих решениях

Статья
11/05/2008

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

В Visual Studio Team System Architecture Edition можно определять приложения и проектировать системы приложений в существующем решении Visual Studio с помощью конструкторов распределенных систем. Эту задачу можно выполнить, если добавить в решение диаграмму приложения или диаграмму системы. Когда выполняется эта задача, среда Visual Studio выполняет реконструирование решения и добавляет на диаграмму приложения определения приложений для соответствующих проектов в решении. Затем в конструкторе приложений можно визуализировать, определить, настроить и реализовать приложения. В конструкторе приложений можно проектировать системы приложений. Дополнительные сведения см. в разделах Практическое руководство. Добавление диаграмм приложений в решения и Практическое руководство. Добавление диаграмм систем к решениям.

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

Реконструирование в существующих решениях
Элементы, не поддерживаемые для реконструирования

Также можно обновить решение с прежней версии Architecture Edition. Однако в этой версии не поддерживаются проекты Visual J#. Дополнительные сведения см. в разделе Обновление предыдущих версий Architecture Edition.

Реконструирование в существующих решениях

После добавления диаграммы приложения в решение среда Visual Studio выполняет реконструирование определенных изменений, вносимых в решение или в проекты в решении. Эти изменения отображаются на открытой диаграмме или после ее повторного открытия.

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

Можно реконструировать любой проект для типа приложения, который поддерживается диаграммой приложения. На диаграмме приложения появится фигура определения приложения для этого проекта.

При реконструировании проектов учитывайте следующие факторы.
- Если отсутствуют необходимые права доступа к метабазе IIS, нельзя реконструировать веб-проекты ASP.NET на диаграмме приложения.
- Свойство Требуемая версия .NET Framework для приложения после реконструирования будет пустым и доступным только для чтения. Требуемую версию платформы можно просмотреть и изменить в свойствах проекта. По умолчанию среда Visual Studio устанавливает параметр Требуемая версия .NET Framework для результирующего приложения в значение .NET Framework 3.5. Проверьте этот параметр и обновите его в случае необходимости. Если этот параметр изменяется, необходимо учитывать определенные моменты. Дополнительные сведения см. в разделе Практическое руководство. Выбор версии платформы .NET Framework для приложений.
- Если реконструируется проект Office, то свойство Шаблон для результирующего приложения будет пустым и доступным только для чтения. Однако в параметре Версия Office для приложения будет отражаться версия Office, используемая проектом. Дополнительные сведения см. в разделе Практическое руководство. Изменение шаблонов проектов для приложений.
- Диаграмма приложения будет заблокирована, если не установлено расширение веб-служб (WSE), но в решении, содержащем диаграмму приложения, выполняется реконструирование или открытие проекта веб-службы, для которой включены параметры расширения веб-служб (WSE).
  
  Чтобы разрешить такую ситуацию, закройте диаграмму, установите расширение WSE, а затем вновь откройте диаграмму. Дополнительные сведения см. в разделе Устранение неполадок на диаграммах приложений.
Дополнительные сведения см. в следующих разделах:
- Практическое руководство. Реконструирование проектов в существующих решениях.
- Элементы, не поддерживаемые для реконструирования
- Типы приложений и прототипы для определения приложений
Добавьте веб-службу в проект для приложения ASP.NET на диаграмме приложения.

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

Среда Visual Studio добавляет операцию в соответствующую конечную точку поставщика веб-службы .NET в определении приложения ASP.NET на диаграмме приложения. Затем можно просмотреть или изменить операцию в окне "Сведения о веб-службе".

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

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

Среда Visual Studio обновляет параметры, хранящиеся в документах модели определения системы (SDM), и в редакторе параметров и ограничений. Дополнительные сведения см. в разделах Общие сведения о модели определения системы (SDM) и Редактор параметров и ограничений.

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

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

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

Если на диаграмме приложения существуют подходящие конечные точки поставщика веб-службы .NET, то между конечными точками потребителя и поставщика веб-службы отображаются подключения. В противном случае появляются новые внешние веб-службы, которые подключаются к точкам потребителя веб-службы.

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

Добавьте веб-ссылку к проекту приложения в решении.

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

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

Например, можно добавить запись подключения к базе данных в файл Web.config для приложения ASP.NET или в файл App.config для приложения Microsoft Windows или Office.

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

Элементы, не поддерживаемые для реконструирования

Конструктор приложений предоставляет ограниченную поддержку или вовсе не поддерживает реконструирование элементов в следующих категориях.

Проекты приложений
- Конструктор приложений не поддерживает проектирование или прямое представление библиотек классов.
  
  Веб-службу ASP.NET можно использовать в качестве оболочки для функций, реализованных в библиотеке классов. Это позволяет представить взаимодействие между библиотекой классов, на которую ссылается приложение ASP.NET, и приложениями, которые поддерживают реализацию на диаграмме приложения. Дополнительные сведения см. в разделе Практическое руководство. Создание ссылок на библиотеки классов в приложениях на диаграммах приложений. Также можно выполнить визуализацию веб-ссылок на веб-службы и пользовательские прокси-классы клиента веб-службы в библиотеке классов в виде конечных точек потребителя веб-службы, добавив соответствующие записи в файл конфигурации приложения-потребителя. Дополнительные сведения см. в разделе Веб-ссылки и пользовательские прокси-классы клиента веб-службы в библиотеках классов.
- Конструктор приложений не поддерживает реконструирование для проектов веб-узлов, основанных на протоколе FTP или на технологии Microsoft SharePoint. Он поддерживает реконструирование только для проектов веб-узлов, которые работают в службах IIS или на сервере разработки ASP.NET.

Веб-службы ASP.NET

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

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

Примечание.
Файл с выделенным кодом представляет файл класса, зависящего от языка программирования, который обычно располагается в папке с кодом приложения для проекта, сопоставленного с приложением ASP.NET.

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

-или-

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

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

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

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

Примечание.
Атрибут WebServiceBinding объявляет привязки на уровне веб-службы. Чтобы использовать эти привязки на уровне веб-методов, можно задать атрибут SoapDocumentMethod или SoapRPCMethod. Дополнительные сведения см. на веб-узле библиотеки MSDN.

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

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