Как обновить net в visual studio

Быстрое обновление проектов .NET с помощью Visual Studio

Теперь можно обновить любое приложение .NET до последней версии .NET в Visual Studio! Мы рады представить его как расширение Visual Studio и обновит ваши платформа .NET Framework или веб-приложения .NET Core и классические приложения. В этом видео Olia показывает, как получить расширение и начать обновление проектов до последней версии .NET в минутах.

Главы

00:00 — Введение
00:40 . Установка помощника по обновлению .NET
Пошаговое руководство по обновлению помощника по обновлению 01:00
03:43 . Обновление ASP.NET MVC до ASP.NET Core MVC
06:25 — оболочка

Главы

00:00 — Введение
00:40 . Установка помощника по обновлению .NET
Пошаговое руководство по обновлению помощника по обновлению 01:00
03:43 . Обновление ASP.NET MVC до ASP.NET Core MVC
06:25 — оболочка

Обзор помощника по обновлению .NET

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

Помощник по обновлению .NET — это расширение Visual Studio и средство командной строки, предназначенное для обновления приложений до последней версии .NET.

Проблемы, связанные с помощником по обновлению .NET, можно подать в Visual Studio, выбрав команду «Отправить>отзыв о>проблеме».

Установка помощника по обновлению

Помощник по обновлению .NET можно установить как расширение Visual Studio или как средство командной строки .NET. Дополнительные сведения см. в разделе «Установка помощника по обновлению .NET».

Поддерживаемые языки

Поддерживаются следующие языки кода:

Поддерживаемые проекты

Поддерживаются следующие типы проектов:

ASP.NET
Функции Azure
Windows Presentation Foundation
Windows Forms
Библиотеки классов
Консольные приложения
.NET Native UWP
Xamarin Forms
.NET MAUI

Варианты обновления

Поддерживаются следующие варианты обновления:

платформа .NET Framework в .NET
.NET Core в .NET
UWP в WinUI 3
Предыдущая версия .NET до последней версии .NET
Функции Azure версии 1-v3 до изолированной версии 4
Xamarin Forms в .NET MAUI
- Преобразования ФАЙЛОВ XAML поддерживают только обновление пространств имен. Для более комплексных преобразований используйте Visual Studio 2022 версии 17.6 или более поздней версии.
Обновление с помощью расширения Visual Studio

После установки расширения помощника по обновлению .NET щелкните правой кнопкой мыши проект в окне Обозреватель решений и выберите «Обновить».

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

Откроется вкладка, которая предоставляет различные стили обновления на основе типа проекта:
- Обновление проекта на месте Этот параметр обновляет проект без копирования.
- Параллельное обновление проекта Копирует проект и обновляет копию, оставляя исходный проект в одиночку.
- Параллельное добавочное Хороший выбор для сложных веб-приложений. Обновление с ASP.NET до ASP.NET Core требует довольно много работы и иногда ручной рефакторинг. Этот режим помещает проект .NET рядом с существующим проектом платформа .NET Framework и направляет конечные точки, реализованные в проекте .NET, а все остальные вызовы отправляются в приложение платформа .NET Framework. Этот режим позволяет медленно обновлять ASP.NET или приложение библиотеки по частям.
После обновления приложения отобразится экран состояния, в котором отображаются все артефакты, связанные с проектом, связанными с обновлением. Каждый артефакт обновления можно развернуть, чтобы узнать больше о состоянии. В следующем списке описаны значки состояния:
- Заполнен зеленый проверка mark: артефакт был обновлен и успешно завершен.
- Незаполненные зеленые проверка mark: средство не нашли ничего о артефакте для обновления.
- Желтый знак предупреждения: артефакт был обновлен, но следует учитывать важные сведения.
- Red X: артефакт должен был быть обновлен, но обновление завершилось сбоем.
Кроме того, действия помощника по обновлению записываются в окно вывода в источник помощника по обновлению, как показано на следующем рисунке:

После обновления проекта необходимо тщательно протестировать его.

Обновление с помощью средства CLI

После установки средства командной строки помощника по обновлению .NET откройте окно терминала и перейдите в каталог, содержащий проект, который требуется обновить. Вы можете использовать команду, чтобы просмотреть доступные upgrade-assistant —help параметры, предоставляемые CLI.

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

Запустите средство с upgrade-assistant upgrade помощью команды, все проекты из текущей папки и ниже перечислены. Средство ИНТЕРФЕЙСА командной строки предоставляет интерактивный способ выбора проекта для обновления. Используйте клавиши со стрелками для выбора элемента и нажмите клавишу ВВОД , чтобы запустить элемент. Выберите проект, который требуется обновить. В примере, приведенном в этой статье, существует четыре проекта в текущей папке:
```
 Selected options ─────────────────────────────────────────────────────────── No options specified, follow steps below to continue Steps ───────────────── Source project ───────────────── Which project do you want to upgrade (found 9)? > MatchingGame (winforms\MatchingGame\MatchingGame.csproj) MatchingGame.Logic (winforms\MatchingGame.Logic\MatchingGame.Logic.csproj) StarVoteControl (csharp\StarVoteControl\StarVoteControl.csproj) WebSiteRatings (csharp\WebSiteRatings\WebSiteRatings.csproj) Navigation Exit 
```
В зависимости от обновляемого проекта вы можете указать способ продолжения обновления:
- Обновление проекта на месте Этот параметр обновляет проект без копирования.
- Параллельное обновление проекта Этот параметр доступен только для платформа .NET Framework проектов. Копирует проект и обновляет копию, оставляя исходный проект в одиночку.
```
 Selected options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Source project C:\Code\winforms\MatchingGame\MatchingGame.csproj Steps ─────────────────────────────── Source project / Upgrade type ─────────────────────────────── How do you want to upgrade project MatchingGame? > In-place project upgrade Side-by-side project upgrade Navigation Back Exit 
```
После этого шага, если существует несколько обновляемых целевых платформ, вы выберете целевой объект:
```
 Selected options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Source project C:\Code\Work\dotnet\dotnet-docs\docs\core\porting\snippets\upgrade-assistant-wpf-framework\winforms\MatchingGame\MatchingGame.csproj Ugrade type Inplace Steps ────────────────────────────────────────────────── Source project / Ugrade type / Target framework ────────────────────────────────────────────────── What is your preferred target framework? > .NET 6.0 (Supported until November, 2024) .NET 7.0 (Supported until May, 2024) .NET 8.0 (Try latest preview features) Navigation Back Exit 
```
После обновления проекта необходимо тщательно протестировать его.

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Миграция на .NET Framework 4.8, 4.7, 4.6 и 4.5

Если приложение создано с использованием более ранней версии .NET Framework, обычно его можно легко обновить до версии .NET Framework 4.5 и ее доработанных выпусков (4.5.1 и 4.5.2), версии NET Framework 4.6 и ее доработанных выпусков (4.6.1 и 4.6.2), версии .NET Framework 4.7 и ее доработанных выпусков (4.7.1 и 4.7.2) или версии .NET Framework 4.8. Откройте проект в Visual Studio. Если проект был создан в более ранней версии Visual Studio, автоматически откроется диалоговое окно Совместимость проекта. Дополнительные сведения об обновлении проекта в Visual Studio см. в статьях о переносе, миграции и обновлении проектов Visual Studio и целевой платформе и совместимости для Visual Studio 2019.

Однако некоторые изменения в платформе .NET Framework требуют внесения изменений в код. Кроме того, возможно, вы захотите воспользоваться преимуществами новых возможностей в версии .NET Framework 4.5 и ее доработанных выпусках, в версии .NET Framework 4.6 и ее доработанных выпусках, в версии .NET Framework 4.7 и ее доработанных выпусках или в версии .NET Framework 4.8. Внесение подобных изменений в приложение для новой версии платформы .NET Framework обычно называется миграцией. Если нет необходимости в миграции приложения, его можно выполнить в среде .NET Framework 4.5 и более поздней версии без перекомпиляции.

Ресурсы миграции

Перед миграцией приложения из более ранних версий .NET Framework на версию 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2 или 4.8 просмотрите следующие документы:
- См. раздел Версии и зависимости, чтобы определить версию среды CLR, лежащую в основе каждой версии .NET Framework, и ознакомиться с рекомендациями по определению целевой платформы для приложений.
- См. сведения о совместимости приложений, чтобы узнать об изменениях среды выполнения и целевой платформы, которые могут повлиять на приложение, а также о том, что с ними делать.
- Просмотрите раздел Устаревшие классы библиотеки классов, чтобы определить устаревшие типы и члены в коде и рекомендуемые альтернативы.
- См. раздел Новые возможности, чтобы узнать о новых возможностях, которые вы, возможно, захотите добавить в приложение.
См. также
- Совместимость приложений
- Миграция из .NET Framework 1.1
- Совместимость версий
- Версии и зависимости
- Практическое руководство. Настройка приложения для включения поддержки .NET Framework версии 4 и выше
- Новые возможности
- Устаревшие классы библиотеки классов
- Официальная политика поддержки .NET Framework
- Проблемы при миграции на .NET Framework 4
Обновление классического приложения Windows Forms до .NET 7

В этой статье описывается обновление классического приложения Windows Forms до .NET 7. Несмотря на то, что Windows Forms работает в .NET, кроссплатформенная технология Windows Forms по-прежнему является платформой только для Windows. Следующие типы проектов, связанных с Windows Forms, можно обновить с помощью помощника по обновлению .NET:
- Проект Windows Forms
- Библиотека элементов управления
- Библиотека для .NET
Вы также должны просмотреть сведения в руководстве по переносу из платформа .NET Framework в .NET.

Не обновляйте проекты Windows Forms Visual Basic. Кажется, что ошибка с расширением. Эта статья будет обновлена при исправлении ошибки.

Необходимые компоненты
- Операционная система Windows
- Visual Studio 2022 версии 17.1 или более поздней версии для .NET 7
- Visual Studio 2022 версии 17.7( предварительная версия 1 или более поздняя версия) для целевого объекта .NET 8
- Расширение помощника по обновлению .NET для Visual Studio
Демонстрационное приложение

Эта статья была написана в контексте обновления проекта примера игры сопоставления Windows Forms, который можно скачать из репозитория GitHub для примеров .NET.

Запуск обновления

Если вы обновляете несколько проектов, начните с проектов, которые не имеют зависимостей. В примере «Игра сопоставления» проект MatchingGame зависит от библиотеки MatchingGame.Logic, поэтому сначала следует обновить MatchingGame.Logic.

Обязательно создайте резервную копию кода, например в системе управления версиями или копии.

Чтобы обновить проект в Visual Studio, выполните следующие действия.
1. Щелкните правой кнопкой мыши проект MatchingGame.Logic в окне Обозреватель решений и выберите «Обновить».Откроется новая вкладка, которая предлагает выбрать способ выполнения обновления.
2. Выберите обновление проекта на месте.
3. Затем выберите целевую платформу. На основе типа проекта, который вы обновляете, вы предоставляете различные варианты. .NET Standard 2.0 является хорошим выбором, если библиотека не полагается на классические технологии, такие как Windows Froms и может использоваться как платформа .NET Framework проектами, так и проектами .NET. Однако последние выпуски .NET предоставляют множество улучшений языка и компилятора по сравнению с .NET Standard. Выберите .NET 7.0 и нажмите кнопку «Далее«.
4. Дерево отображается со всеми артефактами, связанными с проектом, такими как файлы кода и библиотеки. Вы можете обновить отдельные артефакты или весь проект, который используется по умолчанию. Выберите пункт «Обновить», чтобы начать обновление. После завершения обновления отображаются результаты: Артефакты с твердым зеленым кругом были обновлены, в то время как пустые зеленые круги пропускались. Пропущенные артефакты означают, что обновление помощник не нашли ничего для обновления.
Теперь, когда поддержка библиотеки приложения обновлена, обновите основное приложение.

Обновление приложения

После обновления всех вспомогательных библиотек можно обновить основной проект приложения. В примере приложения существует только один проект библиотеки для обновления, который был обновлен в предыдущем разделе.
1. Щелкните правой кнопкой мыши проект MatchingGame в окне Обозреватель решений и выберите «Обновить«.
2. Выберите обновление проекта на месте в качестве режима обновления.
3. Выберите .NET 7.0 для целевой платформы и нажмите кнопку «Далее«.
4. Оставьте все артефакты выбранными и выберите пункт «Обновить».
После завершения обновления отображаются результаты. Обратите внимание, что в проекте Windows Forms есть символ предупреждения. Разверните это и дополнительные сведения об этом шаге:

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

Создание чистой сборки

После обновления проекта очистите и скомпилируйте его.
1. Щелкните правой кнопкой мыши проект MatchingGame в окне Обозреватель решений и выберите «Очистить«.
2. Щелкните правой кнопкой мыши проект MatchingGame в окне Обозреватель решений и выберите «Сборка«.
Если приложение столкнулось с любыми ошибками, их можно найти в окне списка ошибок с рекомендацией по их устранению.

` element uses the `Update` attribute instead of the `Include` attribute. «`xml MyApplicationCodeGenerator Application.Designer.vb True Application.myapp True «` 01. Add the ` WindowsForms ` setting to the `

(contains settings previously described) WindowsForms

«` This setting imports the `My` namespace members Visual Basic programmers are familiar with. 01. Import the namespaces defined by your project. Visual Basic projects can automatically import namespaces into every code file. Copy the ` ` elements from the old project file that contain ` ` into the new file after the `

` closing tag. «`xml «` If you can’t find any ` ` statements, or your project fails to compile, make sure you at least have the following ` ` statements defined in your project: «`xml «` 01. From the original project, copy the ` ` and ` ` settings to the `

(contains settings previously described) On Binary Off On MatchingGame.My.MyApplication

Заключение

Теперь проект «Пример игры «, соответствующий Windows Forms, обновлен до .NET 7. Результаты будут отличаться при переносе собственного проекта. Убедитесь, что вам потребуется время, чтобы просмотреть перенос из платформа .NET Framework в .NET и модернизировать после обновления до .NET из статьи платформа .NET Framework.

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Похожие публикации: