Aracılığıyla paylaş


.NET 9'da hataya neden olan değişiklikler

Bir uygulamayı .NET 9'a geçiriyorsanız, burada listelenen hataya neden olan değişiklikler sizi etkileyebilir. Değişiklikler, ASP.NET Core veya Windows Forms gibi teknoloji alanına göre gruplandırılır.

Bu makalede, her hataya neden olan değişiklik ikili uyumsuz veya kaynak uyumsuz ya da davranış değişikliği olarak kategorilere ayrılmıştır:

  • İkili uyumsuz - Yeni çalışma zamanına veya bileşene karşı çalıştırıldığında, mevcut ikili dosyalar yüklenemiyor veya yürütülemedi gibi hataya neden olan bir davranış değişikliğiyle karşılaşabilir ve bu durumda yeniden derleme gerekir.

  • Kaynak uyumsuz - Yeni SDK veya bileşen kullanılarak veya yeni çalışma zamanını hedeflemek için yeniden derlendiğinde, mevcut kaynak kodun başarıyla derlenebileceği kaynak değişiklikleri gerekebilir.

  • Davranış değişikliği - Var olan kod ve ikili dosyalar çalışma zamanında farklı davranabilir. Yeni davranış istenmeyen bir davranışsa mevcut kodun güncelleştirilip yeniden derlenmesi gerekir.

Not

Bu makale devam eden bir çalışmadır. .NET 9'daki hataya neden olan değişikliklerin tam listesi değildir. Yayın bekleyen hataya neden olan değişiklikleri sorgulamak için bkz . .NET sorunları.

ASP.NET Core

Başlık Değişiklik türü Tanıtılan sürüm
DefaultKeyResolution.ShouldGenerateNewKey'in anlamı değişti Davranış değişikliği Preview 3
Geliştirme sertifikası dışarı aktarma işlemi artık klasör oluşturmaz Davranış değişikliği RC 1
HostBuilder geliştirme ortamında ValidateOnBuild/ValidateScopes'u etkinleştirir Davranış değişikliği Önizleme 7
Küresel ad alanına aktarılmayan Legacy Mono ve Emscripten API'leri Kaynak uyumsuz GA
Birden çok oluşturucuya sahip ara yazılım türleri Davranış değişikliği RC 1

Kapsayıcılar

Başlık Değişiklik türü Tanıtılan sürüm
Kapsayıcı görüntüleri artık zlib yüklenemiyor Davranış değişikliği Önizleme 7
.NET İzleyici görüntüleri, yalnızca sürüm etiketlerine indirgenmiştir Davranış değişikliği Preview 5

Core .NET kitaplıkları

Başlık Değişiklik türü Tanıtılan sürüm
CompressionLevel ile ZipArchiveEntry ekleme, ZIP merkezi dizin üst bilgisi genel amaçlı bit bayraklarını ayarlar Davranış değişikliği Preview 5
Açık olmayan genel değerler için değiştirilmiş UnsafeAccessor desteği Davranış değişikliği Önizleme 6
Özel tanılama kimlikleriyle API obsoletions Kaynak uyumsuz (Birden çok)
StringValues örtük işleçlerini etkileyen belirsiz aşırı yükleme çözümlemesi Kaynak uyumsuz GA
BigInteger maksimum uzunluk Davranış değişikliği Önizleme 6
BinaryReader.GetString() yanlış biçimlendirilmiş dizilerde "\uFFFD" döndürür Davranış değişikliği Önizleme 7
C# çözümlemesi, params span türü aşırı yüklemeleri tercih eder Kaynak uyumsuz
System.Void dizisinin türü oluşturulmasına izin verilmiyor Davranış değişikliği Önizleme 1
Varsayılan Equals() ve GetHashCode() ile işaretlenmiş türler için throw InlineArrayAttribute Davranış değişikliği Önizleme 6
EnumConverter kayıtlı türlerin sabit listesi olduğunu doğrular Davranış değişikliği Önizleme 7
FromKeyedServicesAttribute artık anahtarlanmamış parametre eklemez Davranış değişikliği RC 1
IncrementingPollingCounter ilk geri çağırma zaman uyumsuz Davranış değişikliği RC 1
Satır içi dizi yapısı boyut sınırı zorunlu kılındı Davranış değişikliği Önizleme 1
InMemoryDirectoryInfo, rootDir'i dosyalara önceden eklir Davranış değişikliği Önizleme 1
Tamsayılar kullanan yeni TimeSpan.From*() aşırı yüklemeleri Kaynak uyumsuz Preview 3
Bazı OOB paketlerinin yeni sürümü Kaynak uyumsuz Preview 5
RuntimeHelpers.GetSubArray farklı tür döndürür Davranış değişikliği Önizleme 1
String.Trim(params ReadOnlySpan<char>) aşırı yüklemesi kaldırıldı Kaynak/ikili uyumsuz GA
Boş ortam değişkenleri desteği Davranış değişikliği Önizleme 6
ZipArchiveEntry adları ve açıklamaları UTF8 bayrağına uygun Davranış değişikliği RC 1

Şifreleme

Başlık Değişiklik türü Tanıtılan sürüm
SafeEvpPKeyHandle.DuplicateHandle tanıtıcıyı yeniden oluşturur Davranış değişikliği Önizleme 7
Bazı X509Certificate2 ve X509Certificate oluşturucuları kullanımdan kaldırıldı Kaynak uyumsuz Önizleme 7
Windows özel anahtar ömrü basitleştirilmiş Davranış değişikliği Önizleme 7

Dağıtım

Başlık Değişiklik türü Tanıtılan sürüm
Kullanım dışı masaüstü Windows/macOS/Linux MonoVM çalışma zamanı paketleri Kaynak uyumsuz Önizleme 7

Interop

Başlık Değişiklik türü Tanıtılan sürüm
CET varsayılan olarak desteklenir İkili uyumsuz Önizleme 6

JIT derleyicisi

Başlık Değişiklik türü Tanıtılan sürüm
Kayan noktadan tamsayıya dönüştürmeler doygunlukta Davranış değişikliği Preview 4
Bazı SVE API'leri kaldırıldı Kaynak uyumsuz RC 2

Başlık Değişiklik türü Tanıtılan sürüm
API obsoletions Kaynak uyumsuz Önizleme 6
HttpClient ölçümleri raporu server.port koşulsuz olarak Davranış değişikliği Önizleme 7
HttpClientFactory günlüğü üst bilgi değerlerini varsayılan olarak yeniden uygular Davranış değişikliği RC 1
HttpClientFactory, birincil işleyici olarak SocketsHttpHandler kullanır Davranış değişikliği Önizleme 6
HttpListenerRequest.UserAgent null atanabilir Kaynak uyumsuz Önizleme 1
HttpClient EventSource olaylarında URI sorgu yeniden oluşturma Davranış değişikliği Önizleme 7
IHttpClientFactory günlüklerinde URI sorgusu yeniden düzenleme Davranış değişikliği Önizleme 7

SDK ve MSBuild

Başlık Değişiklik türü Tanıtılan sürüm
dotnet restore geçişli paketleri denetler Davranış değişikliği Önizleme 6
dotnet sln add geçersiz dosya adları izin vermiyor Davranış değişikliği 9.0.2xx
dotnet watcheski çerçeveler için Çalışırken Yeniden Yükleme uyumsuz Davranış değişikliği RC 1
dotnet workload komut çıktı değişikliği Davranış değişikliği Önizleme 1
installer depo sürümü artık belgelenmemiş Davranış değişikliği Preview 5
.NET Framework hedeflenirken kullanılan yeni varsayılan RID Kaynak uyumsuz GA
Terminal günlükçü varsayılan değerdir Davranış değişikliği Önizleme 1
.NET 9 SDK'sı için sürüm gereksinimleri Kaynak uyumsuz GA
.NET Standard 1.x hedefi için uyarı gönderildi Kaynak uyumsuz Önizleme 6
.NET 7 hedefi için uyarı gönderildi Kaynak uyumsuz GA

Serileştirme

Başlık Değişiklik türü Tanıtılan sürüm
BinaryFormatter her zaman atar Davranış değişikliği Önizleme 6
Null Atanabilir JsonDocument özellikleri JsonValueKind.Null için seri durumdan çıkarılır Davranış değişikliği Önizleme 1
System.Text.Json meta veri okuyucusu artık meta veri özellik adlarının kaçış karakterlerini kaldırıyor Davranış değişikliği GA

Windows Forms

Başlık Değişiklik türü Tanıtılan sürüm
BindingSource.SortDescriptions null döndürmüyor Davranış değişikliği Önizleme 1
Null atanabilirlik ek açıklamalarında yapılan değişiklikler Kaynak uyumsuz Önizleme 1
ComponentDesigner.Initialize ArgumentNullException oluşturur Davranış değişikliği Önizleme 1
Başlangıç satırı dizinini DataGridViewRowAccessibleObject.Name Davranış değişikliği Önizleme 1
IMsoComponent desteği kabul edilir Davranış değişikliği Önizleme 2
Yeni güvenlik çözümleyicileri Kaynak uyumsuz RC 1
DataGridView null olduğunda özel durum yok Davranış değişikliği Önizleme 1
PictureBox HttpClient özel durumlarını tetikler Davranış değişikliği Önizleme 6
StatusStrip farklı bir varsayılan işleyici kullanır Davranış değişikliği GA

WPF

Başlık Değişiklik türü Tanıtılan sürüm
GetXmlNamespaceMaps tür değişikliği Davranış değişikliği/Kaynak uyumsuz Preview 3

Ayrıca bkz.