İngilizce dilinde oku

Aracılığıyla paylaş

.NET Yükseltme Yardımcısı nedir?

  • Makale

.NET Yükseltme Yardımcısı projelerin .NET'in daha yeni sürümlerine yükseltilmesine yardımcı olur ve olası uyumsuzlukları tespit etmek ve düzeltmek için kodunuzu analiz eder. Aracın odak noktası, bir projenin .NET Framework, .NET Core veya .NET'ten en son .NET sürümüne geçirilmesine yardımcı olmaktır. Uzantıyı veya aracı kullanarak tüm .NET projelerini veya bir yapılandırma dosyasını daha eski bir türden daha yeni bir türe geçirme gibi projenin bazı yönlerini yükseltebilirsiniz.

.NET Yükseltme Yardımcısı, Visual Studio uzantısı veya komut satırı arabirimi (CLI) aracı olarak dağıtılır.

Analiz etme ve yükseltme

.NET Yükseltme Yardımcısı, projelerinizi ve bunların bağımlılıklarını tarar bir analiz altyapısı içerir. Tarama tamamlandıktan sonra, yükseltme gerçekleştirme hakkında ayrıntılı bilgiler içeren bir rapor oluşturulur. Projenin tamamını veya projenin belirli bölümlerini yükseltmek için bu bilgileri kullanabilirsiniz.

Desteklenen proje türleri

.NET Yükseltme Yardımcısı, C# veya Visual Basic'te kodlanmış projeleri yükseltmeyi destekler. Aşağıdaki proje türleri desteklenir:

  • ASP.NET
  • Azure İşlevleri
  • Windows Presentation Foundation
  • Windows Forms
  • Sınıf kitaplıkları
  • Konsol uygulamaları
  • Xamarin Forms
  • .NET MAUI
  • .NET Native UWP

Bazı ürünler .NET Yükseltme Yardımcısı'nı kullanma konusunda rehberlik sağlar.

Yükseltme yolları

Aşağıdaki yükseltme yolları desteklenmektedir:

  • .NET Framework'e .NET
  • .NET Core'da .NET'e
  • Azure İşlevleri v1-v3'den v4'e yalıtılmış (net6.0+'ı hedefleme)
  • WinUI 3'e UWP
  • En son .NET sürümüne önceki .NET sürümü
  • Xamarin Forms to .NET MAUI
    • XAML dosya dönüştürmeleri yalnızca ad alanlarını yükseltmeyi destekler. Daha kapsamlı dönüştürmeler için Visual Studio 2022 sürüm 17.6 veya üzerini kullanın.

Yükseltme ayrıntıları ve seçenekleri

Yükseltme başlatıldığında, sihirbaz yükseltme başlatılmadan önce bazı seçenekleri yapılandırma konusunda size yol gösterir. Yükseltirken kullandığınız projenin türüne bağlı olarak sihirbaz farklı seçenekler sunar. Projeyi yükseltme örneği için bkz . .NET Yükseltme Yardımcısı ile projeleri yükseltme.

Yükseltmenin nasıl gerçekleştirilmesi gerekir?

Yükseltmekte olduğunuz projenin türüne bağlı olarak, yükseltmenin nasıl gerçekleştirileceğini değiştirebilirsiniz. Proje türü hangi seçeneklerin kullanılabilir olduğunu etkiler ve aşağıdaki öğelerden biri veya daha fazlası eksik olabilir:

  • Yerinde proje yükseltme

    Bu seçenek, kopya oluşturmadan projenizi yükselter.

  • Yan yana proje yükseltme

    Projenizi kopyalar ve kopyayı yükselterek özgün projenizi tek başına bırakır.

  • Yan yana artımlı

    Bu, karmaşık web uygulamaları için iyi bir seçimdir. ASP.NET'den ASP.NET Core'a yükseltmek için biraz çalışma ve bazen el ile yeniden düzenleme gerekir. Bu mod, var olan .NET Framework projesinin yanına bir .NET projesi yerleştirir. Uç noktalar .NET projesi aracılığıyla yönlendirilirken, diğer tüm çağrılar .NET Framework uygulamasına gönderilir.

    Bu mod, ASP.NET veya kitaplık uygulamanızı parça parça yükseltmenizi sağlar.

Yükseltme sonuçları

Yükseltme tamamlandıktan sonra, yükseltmeyle ilişkili tüm yapıtları gösteren bir durum ekranı görüntülenir. Her yükseltme yapıtı, durum hakkında daha fazla bilgi okumak için genişletilebilir. Aşağıdaki listede durum simgeleri açıklanmaktadır:

  • Doldurulmamış yeşil onay işareti: Araç yükseltilen yapıtla ilgili hiçbir şey bulamadı.
  • Dolu yeşil onay işareti: Yapıt yükseltildi ve başarıyla tamamlandı.
  • Sarı uyarı işareti: Yapıt yükseltildi, ancak dikkate almanız gereken önemli bilgiler var.
  • Kırmızı X: Yapıt yükseltmesi başarısız oldu.

Visual Studio'da .NET Yükseltme Yardımcısı'nın Yükseltme sonuçları sekmesi.

Ayrıca, yükseltme sırasında gerçekleştirilen eylemler, aşağıdaki görüntüde gösterildiği gibi Yükseltme Yardımcısı kaynağının altındaki Çıkış penceresine kaydedilir:

Visual Studio'da .NET Yükseltme Yardımcısı'ndan alınan sonuçları gösteren çıkış penceresi.

Projenizi yükselttikten sonra kapsamlı bir şekilde test edin!

İlgili içerik