.NET Yükseltme Yardımcısı'nı yükleme

Bu makalede, Visual Studio uzantısını veya komut satırı arabirimi (CLI) aracını kullanarak .NET Yükseltme Yardımcısı'nı yüklemeyi öğreneceksiniz.

Önemli

.NET Yükseltme Yardımcısı resmi olarak kullanım dışıdır. Bunun yerine, Visual Studio 2026 ve Visual Studio 2022 17.14.16 veya üzeri sürümlerde bulunan GitHub Copilot uygulama modernleştirme sohbet aracısını kullanın. Bu aracı projelerinizi ve bağımlılıklarınızı analiz eder, hedeflenen öneriler ve otomatik kod düzeltmeleri içeren adım adım bir geçiş planı oluşturur ve her değişikliği işleyerek doğrulayabilir veya geri alabilirsiniz. Proje dosyalarını güncelleştirme, kullanım dışı API'leri değiştirme ve derleme sorunlarını çözme gibi yaygın taşıma görevlerini otomatikleştirir, böylece el ile daha az çabayla daha hızlı modernleştirebilirsiniz.

Önkoşullar

• Windows İşletim Sistemi
• Visual Studio 2022 veya üzeri.
• .NET SDK 8 veya üzeri.

Yöntemler

.NET Yükseltme Yardımcısı bir Visual Studio uzantısı veya .NET Genel Aracı olarak yüklenebilir.

Visual Studio uzantısı, açtığınız çözümde veya projede Visual Studio'da çalışır. .NET Genel Aracı, geçerli dizinin altındaki veya altındaki bir çözüm veya proje dosyası üzerinde çalışan etkileşimli bir konsol uygulamasıdır.

Visual Studio'da bir projeyi açma ve yükseltmenin kolaylaştırılmış deneyimini istiyorsanız uzantıyı yükleyin.

Visual Studio Uzantısı

Aşağıdaki adımlar Visual Studio uzantısını yükler.

İpucu

Visual StudioUzantıları Yönet özelliğini kullanmaya alternatif olarak, Visual Studio Marketuzantı yükleyicisini indirip çalıştırabilirsiniz.

1. Visual Studio'yu açın.

   En Son Aç \ Başlarken penceresi açılırsa Kod olmadan devam et bağlantısını seçin.

2. Uzantı Yöneticisi penceresini açmak için Uzantılar> Uzantıları Yönet menüsünü seçin.

3. Gözat sekmesini seçin.

4. Arama kutusuna .NET yükseltme yardımcısı yazın.

5. .NET Yükseltme Yardımcısı öğesini ve ardından Yükle'yi seçin.

   

6. Uzantının indirilmesi tamamlandıktan sonra, yüklemeyi otomatik olarak başlatmak için Visual Studio'yu kapatın.

   

7. Değiştir'i seçin ve uzantıyı yüklemek için yönergeleri izleyin.

.NET Genel Aracı

Aşağıdaki adımlar .NET Yükseltme Yardımcısı'nı .NET Genel Aracı olarak yükler. .NET Yükseltme Yardımcısı, yükseltme yardımcısı NuGet paketinde dağıtılır.

1. Yol'da komutu olan dotnet bir komut istemi açın.

2. Aracı yüklemek için aşağıdaki komutu çalıştırın:

   dotnet tool install -g upgrade-assistant
   

   Önemli

   Başka bir NuGet akış kaynağı yapılandırdıysanız bu aracı yükleme işlemi başarısız olabilir. --ignore-failed-sources Bu hataları, diğer NuGet akış kaynaklarını atlayarak hata yerine uyarı olarak işlemek için parametresini kullanın:

   dotnet tool install -g --ignore-failed-sources upgrade-assistant
   

Doğrulama

Aşağıdaki bilgiler .NET Yükseltme Yardımcısı'nın yüklü olduğunu belirlemenize yardımcı olur.

• Visual Studio Uzantısı

  .NET Yükseltme Yardımcısı'nın Visual Studio uzantısı olarak yüklenip yüklenmediğini belirlemenin iki yolu vardır. En hızlı yol, Çözüm Gezgini penceresinde herhangi bir .NET veya .NET Framework projesine sağ tıklayıp Yükseltme menü öğesini denetlemektir.

  Bir diğer yol da Uzantı Yöneticisi penceresini açmak için Uzantıları> Yönet menüsünü seçmektir. Ardından, Yüklü sekmesini seçin ve yüklü uzantılar listesinde bulun.

• .NET Genel Aracı

  Bir komut istemi açın ve komutunu çalıştırın upgrade-assistant . Komut yanıtı komutun bilinmediğini belirtiyorsa, araç doğru yüklenmemiş veya PATH'de değil.

Sorun Giderme - .NET Genel Aracı

Ek NuGet akışı kaynakları yapılandırdıysanız yükleme, NuGet paketinin akışta kullanılamadığını belirten bir hatayla başarısız olabilir. --ignore-failed-sources Diğer NuGet akış kaynaklarını atlayarak bu hataları hatalar yerine uyarı olarak işlemek için parametresini kullanın:

dotnet tool install -g --ignore-failed-sources upgrade-assistant