Что такое помощник по обновлению .NET?

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

Помощник по обновлению .NET распространяется как расширение Visual Studio или средство интерфейса командной строки .NET.

Анализ и обновление

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

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

Помощник по обновлению .NET поддерживает обновление проектов, закодированных в C# или Visual Basic. Поддерживаются следующие типы проектов:

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

Некоторые продукты предоставляют рекомендации по использованию помощника по обновлению .NET.

• ASP.NET
• Фундамент представления Windows
• Формы Windows
• Универсальная платформа Windows
• Windows Communication Foundation (Фундамент Windows для связи)

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

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

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

Сведения о обновлении и параметры

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

Как следует выполнить обновление

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

• Обновление проекта на месте

  Этот параметр обновляет проект без копирования.

• Параллельное обновление проекта

  Копирует проект и обновляет копию, оставляя исходный проект в одиночку.

• Параллельное добавочное

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

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

Результаты обновления

После завершения обновления отображается экран состояния, в котором отображаются все артефакты, связанные с обновлением. Каждый артефакт обновления можно развернуть, чтобы узнать больше о состоянии. В следующем списке описаны значки состояния:

• Незаполненные зеленые флажки: инструмент не обнаружил ничего о артефакте для обновления.
• Заполнен зеленый флажок: артефакт был обновлен и успешно завершен.
• Желтый знак предупреждения: артефакт был обновлен, но следует учитывать важные сведения.
• Red X: обновление артефакта было неудачным.

Кроме того, действия, выполняемые во время обновления, записываются в окно вывода в источник помощника по обновлению, как показано на следующем рисунке:

После обновления проекта проверьте его тщательно!

Связанный контент

• Что такое анализ кода с помощью помощника по обновлению .NET?
• Установка помощника по обновлению .NET
• Анализ проектов с помощью помощника по обновлению .NET
• Обновление проектов с помощью помощника по обновлению .NET