Пошаговое руководство. Преобразование веб-проекта Visual Studio .NET 2003 в проект веб-приложения

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

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

Модель проекта веб-приложения Visual Studio 2008 в большей степени соответствует модели проектов для приложений Visual Studio .NET 2003. Это может оказаться полезным при преобразовании веб-проекта Visual Studio .NET 2003 в Visual Studio 2008. Дополнительные сведения о новых возможностях см. в разделе Новые возможности ASP.NET и веб-разработки.

Примечание.
Для создания проектов веб-приложений ASP.NET используется Visual Studio или Visual Web Developer, экспресс-выпуск.

В данном пошаговом руководстве объясняются принципы преобразования существующего веб-проекта Visual Studio .NET 2003 в проект веб-приложения в Visual Studio 2008. Модель проекта веб-приложения использует тот же концептуальный подход, что и веб-проект в Visual Studio .NET 2003. Это подразумевает включение и исключение файлов файлом проекта, а также компиляцию в единую сборку. Дополнительные сведения см. в разделе Преобразование веб-проекта из Visual Studio .NET.

Примечание.
Чтобы преобразовать веб-узел, использующий Microsoft Office FrontPage 2003, в проект веб-приложения, сначала следует преобразовать веб-узел FrontPage в проект веб-узла Visual Studio 2008. Затем необходимо преобразовать проект веб-узла в проект веб-приложения. Дополнительные сведения см. в разделе Пошаговое руководство. Преобразование проекта веб-узла в проект веб-приложения в Visual Studio.

В данном пошаговом руководстве представлены следующие задачи:

• Открытие и проверка веб-проекта Visual Studio .NET 2003.

• Создание резервной копии веб-проекта Visual Studio .NET 2003.

• Преобразование веб-проекта Visual Studio .NET 2003 в Visual Studio 2008.

• Проверка проекта веб-приложения в Visual Studio 2008.

• Преобразование классов с выделенным кодом в разделяемые классы.

• Рассмотрение и разрешение вопросов, связанных с XHTML-совместимостью.

Обязательные компоненты

Для выполнения этого пошагового руководства потребуется следующее.

• Visual Studio .NET 2003

• Visual Studio 2008 или Visual Studio 2005 с пакетом обновления 1 (SP1) или Visual Web Developer, экспресс-выпуск

• .NET Framework, версия 2.0

Открытие и проверка веб-проекта Visual Studio .NET 2003.

Перед выполнением преобразования проекта необходимо проверить правильность его работы. Это поможет предотвратить возникновение ошибок во время преобразования.

Открытие и проверка веб-проекта Visual Studio .NET 2003

1. Откройте Visual Studio .NET 2003.

2. В меню Файл выберите Открыть, а затем введите или выберите имя файла SLN того решения, проверку которого необходимо выполнить.

   Примечание.
   В Visual Studio .NET 2003 файлы, из которых состоит проект, включены в файл решения (SLN).

3. В меню Проект выберите команду Построить решение.

4. В меню Отладка выберите команду Запуск.

5. Проверьте правильность работы проекта.

Создание резервной копии веб-проекта Visual Studio .NET 2003.

Рекомендуется создавать резервную копию решения Visual Studio .NET 2003 и файлов проекта прежде, чем запустить процесс преобразования. В случае возникновения проблем при выполнении преобразования можно вернуться к сохраненной резервной копии решения Visual Studio .NET 2003.

Чтобы создать резервную копию проекта, следует скопировать проект в Visual Studio .NET 2003.

Создание резервной копии веб-проекта Visual Studio .NET 2003 перед выполнением преобразования.

1. Откройте Visual Studio .NET 2003.

2. В меню Файл выберите Открыть, а затем введите или выберите имя файла SLN того решения, резервную копию которого необходимо создать.

3. В меню Проект выберите команду Копировать проект.

4. В поле Копировать проект выберите папку проектаКонечная папка.

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

6. Выберите параметр Включить все файлы в папку проекта и нажмите OK.

Преобразование веб-проекта Visual Studio .NET 2003 в Visual Studio 2008

Visual Studio 2008 выполняет преобразование решения Visual Studio .NET 2003 и файлов проекта для использования формата Microsoft Build Engine (MSBuild), который является форматом файлов проекта в Visual Studio 2008.

В рамках процесса преобразования Visual Studio 2008 создает файл журнала XML, который содержит сводную информацию о преобразовании, а также указывает ошибки и неисправности. По умолчанию файл журнала преобразования сохраняется в том же каталоге, что и файл SLN. В случае возникновения проблем при компиляции преобразованного проекта, можно вернуться к файлу журнала преобразования.

Преобразование веб-проекта в Visual Studio 2008

1. В Visual Studio .NET 2003 закройте файл решения.

2. Откройте Visual Studio 2008.

3. В меню Файл выберите команду Открыть, а затем введите или выберите имя файла SLN того решения, преобразование которого необходимо выполнить.

   Откроется Мастер преобразования Visual Studio 2008.

4. Нажмите кнопку Далее и следуйте инструкциям мастера, затем нажмите кнопку Готово.

Проверка проекта веб-приложения в Visual Studio 2008

После преобразования файлов решения и проекта в формат Visual Studio 2008 следует убедиться, что построение приложения выполняется без ошибок и что приложение работает правильно.

Проверка проекта веб-приложения в Visual Studio 2008

1. В Visual Studio 2008, в меню Файл выберите команду Открыть, а затем введите или выберите файл SLN того решения, проверку которого необходимо выполнить.

2. В меню Проект выберите команду Построить решение.

3. В меню Отладка выберите команду Запуск.

4. Проверьте работу проекта веб-приложения.

Типичные ошибки и предупреждения

Наиболее часто во время преобразования возникают следующие ошибки и предупреждения:

• Конфликты с именами, которые представлены в .NET Framework, версия 2.0.

• Предупреждения об устаревших членах.

• Проблемы при запуске веб-приложения.

Чтобы разрешить конфликты именования, следует устранить неоднозначность посредством полного определения существующих имен через пространство имен. Кроме того, можно переименовать конфликтующие типы и члены таким образом, чтобы устранить конфликт. Дополнительные сведения о конфликтах именования см. в разделах Общие сведения о миграции ASP.NET 2.0 and Правила именования пространств имен.

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

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

Преобразование классов с выделенным кодом в разделяемые классы.

В Visual Studio 2008 проекты веб-приложения используют разделяемые классы для кода, созданного Visual Studio. Данные классы хранятся в файле, отдельно от с выделенным кодом. По умолчанию мастер преобразования Visual Studio 2008 не создает ни файл *.designer.cs или *.designer.vb для веб-страниц (ASPX-файлы), ни пользовательские элементы управления (ASCX-файлы). Вместо этого код будет выглядеть или функционировать так же, как и в Visual Studio .NET 2003.

Примечание.
Мастер преобразования Visual Studio 2008 в процессе преобразования вносит минимум изменений в файлы кода. Это помогает избежать возникновения проблем при преобразовании в проект веб-приложения в Visual Studio 2008.

Можно сохранить код в формате Visual Studio .NET 2003. При этом необходимо обновить объявления полей элементов управления в файле с выделенным кодом так же, как в Visual Studio .NET 2003. Тем не менее, чтобы использовать способность созданного кода содержать объявления полей, следует обновить страницы и элементы управления для использования модели разделяемого класса. Разделяемые классы помогают организовать сгенерированный код и пользовательский код для файлов с выделенным кодом. Дополнительные сведения см. в разделах Partial (Visual Basic) и разделяемый (тип) (Справочник по C#).

Преобразование кода для использования модели разделяемого класса

1. Следует убедиться, что компиляция кода выполняется без ошибок.

2. В Обозревателе решений щелкните правой кнопкой мыши и выберите команду Преобразовать в веб-приложение.

   Эта команда выполняет итерацию каждой страницу и каждого пользовательского элемента управления в проекте. Далее, все объявления элемента управления перемещаются в файл DESIGNER.CS или DESIGNER.VB. Данная команда также добавляет объявления обработчика событий в разметку серверных элементов управления в файлах ASPX и ASCX.

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

   Команда Преобразовать в веб-приложения не подлежит отмене. Отменить изменения проще всего путем восстановления данных из резервной копии проекта Visual Studio .NET 2003 и последующего повторного запуска процесса преобразования Visual Studio 2008, как описано выше.

3. По завершении процесса следует проверить наличие сообщений об ошибках преобразования в окне Список задач.

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

   Примечание.
   Ошибки и предупреждения, которые выводятся в окне Список задач, не устраняются в интервалах между сеансами Visual Studio. После устранения ошибок, отображаемых в окне, можно удалить элементы из списка задач.

5. Необходимо выполнить повторную компиляцию проекта, чтобы убедиться, что компиляция выполняется без ошибок.

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

Рассмотрение и разрешение проблем с XHTML-совместимостью

По умолчанию Visual Studio 2008 создает и проверяет XHTML-совместимую разметку. Это облегчает построение веб-приложений, соответствующих стандартам, и помогает свести к минимуму возникновение проблем при отрисовке, зависящей от обозревателя. По умолчанию Visual Studio .NET 2003 не создает XHTML-совместимую разметку. Таким образом, после преобразования веб-приложения в формат Visual Studio 2008 могут возникнуть проблемы с визуализацией и проверкой страниц, созданных в Visual Studio .NET 2003.

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

Если необходимо просмотреть ошибки, возникшие при проверке HTML, также, как в Visual Studio .NET 2003, следует изменить настройки проверки HTML XHTML Переходный на Обозреватель Internet Explorer 6.0. Обозреватель Internet Explorer 6.0 установлен для проверки HTML в качестве настройки по умолчанию в Visual Studio .NET 2003. Дополнительные сведения см. в разделе Практическое руководство. Выбор схем проверки для редактора HTML в Visual Web Developer.

Можно также добавить следующий раздел в файл проекта Web.config, который инициализирует отрисовку АSP.NET устаревшей (не совместимой с XHTML) разметки из серверных элементов управления:

<system.Web>
  <xhtmlConformance mode="Legacy" />
</system.Web>

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

См. также

Задачи

Практическое руководство. Обновление проектов, созданных в Visual Studio .NET 2002 или 2003

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

Преобразование веб-проекта из Visual Studio .NET

Общие сведения о миграции ASP.NET 2.0

Модель кода веб-страниц ASP.NET

ASP.NET и XHTML

Ссылки

Partial (Visual Basic)

разделяемый (тип) (Справочник по C#)

Разделяемые классы и методы (Руководство по программированию в C#)

Мастер преобразования Visual Studio

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

Правила именования пространств имен