Что такое помощник по обновлению .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 Presentation Foundation
- Windows Forms
- Универсальная платформа Windows
- Windows Communication Foundation
Варианты обновления
Поддерживаются следующие варианты обновления:
- платформа .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: обновление артефакта было неудачным.
Кроме того, действия, выполняемые во время обновления, записываются в окно вывода в источник помощника по обновлению, как показано на следующем рисунке:
После обновления проекта проверьте его тщательно!
