Бөлісу құралы:

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

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

Помощник по обновлению .NET встроен в Visual Studio и может быть установлен как средство интерфейса командной строки (CLI).

Это важно

Помощник по обновлению .NET официально устарел. Вместо этого используйте агент чата модернизации GitHub Copilot , который входит в состав Visual Studio 2026 и Visual Studio 2022 17.14.16 или более поздней версии. Этот агент анализирует проекты и зависимости, создает пошаговый план миграции с целевыми рекомендациями и автоматическими исправлениями кода и фиксирует каждое изменение, чтобы можно было проверить или откатить. Она автоматизирует распространенные задачи переноса — обновление файлов проекта, заменяя устаревшие API и устраняя проблемы сборки, чтобы ускорить модернизацию с меньшими усилиями вручную.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вкладка результатов обновления помощника по обновлению .NET в Visual Studio.

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

Окно вывода в Visual Studio с результатами помощника по обновлению .NET.

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

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

  • Last updated on