Iron Suite for .NET
10 .NET kütüphanesi. Tek bir tam belge suiti.
.NET 11'e Geçiş mi Yapıyorsunuz? Önce Bu Bozucu Değişiklikleri Kontrol Edin
.NET 11 yaklaşıyor ve önemli değişiklikler listesi zaten yayında. Yükseltmeye neye dikkat etmeniz gerektiğini bilerek başlayabilmeniz için satır satır inceledik.
Bu iyi bir haber, ancak aynı zamanda geçiş testlerini daha önemli hale getiriyor.
Birçok uygulama, .NET 11'e yeniden hedeflendikten sonra hala sorunsuz bir şekilde derlenecektir. Daha büyük risk, davranışsal değişikliktir: Başarıyla derlenen ancak yeni bir istisna atan, verileri farklı şekilde işleyen veya çalışma zamanında biraz farklı sonuçlar üreten kod.
Her uyumluluk maddesini tek tek incelemek yerine, bu kılavuz gerçek uygulamaları etkileme olasılığı en yüksek olan değişikliklere ve üretime geçmeden önce test etmeniz gerekenlere odaklanır.
Hepsi tek bir tabloda
| Değişiklik | Ne olur |
|---|---|
| ZIP okuma CRC32'yi doğrular | Bozuk girişlerde InvalidDataException atar |
DateOnly/TimeOnly TryParse | Geçersiz format veya stilde atar |
BackgroundService hatası | Ana bilgisayar başlatma/kapatma sırasında atar |
| Math.Round doğruluğu | Doğru yuvarlanmış sonuçlar döndürür |
| Paylaşılan çerçevede uzantılar | Derleme sürümü çözümü değişebilir |
| Derleme ve test araçları | VSTest, NuGet, şablon motoru değişiklikleri |
İlk kontrol edeceğimiz: ZIP okuma artık atıyor
Bu, belge ağırlıklı bir kod tabanını şaşırtma olasılığı en yüksek olan değişikliktir, çünkü sessizdir, ta ki sessiz olmayana kadar. .NET 11'de, System.IO.Compression bir ZIP girişini okuduğunuzda CRC32 sağlama toplamını doğrular ve saklanan sağlama toplamı verilerle eşleşmezse InvalidDataException atar. Daha önce, bozuk veya değiştirilmiş bir giriş herhangi bir şikayet olmadan doğrudan okunurdu.
Bu gerçekten iyi bir değişikliktir, bir dosyanın kötü olduğunu bilmek istersiniz, ancak uygulamanız kullanıcılar, ortaklar veya eski bir depolama kovasından ZIP dosyalarını alıyorsa, yıllardır "çalışan" kod atmaya başlayabilir. Çözüm küçük: Okumanızı InvalidDataException için bir try-catch ile sarın ve kötü bir arşivi nasıl ele almak istediğinize karar verin. Bunu bilerek yakalamak, üretimde keşfetmekten daha iyidir.
Gizli olan: TryParse artık atabilir
Her .NET geliştiricisi TryParse'ın asla atmadığını, bir bool döndürdüğünü içselleştirmiştir. .NET 11'de, DateOnly.TryParse, TimeOnly.TryParse ve onların TryParseExact kardeşleri bu alışkanlığı biraz bozar: Geçersiz bir DateTimeStyles değeri veya kötü bir format belirleyici geçirin ve artık sessizce false döndürmek yerine ArgumentException atarlar. Format dizeleriniz ve stilleriniz sabit kodlanmış ve geçerliyse, hiçbir şey değişmez. Eğer bunlar çalışma zamanında hesaplanıyorsa veya kullanıcı girdisinden geliyorsa, bu yeni bir istisna yoludur.
Sadece sizin dünyanızsa kontrol edin
Geri kalanlar daha dar kapsamlıdır ve bulundukları yere göre gruplandırılmıştır:
- ASP.NET Core. Yıllar önce kullanımdan kaldırılan eski Blazor API'leri artık derlenmiyor. Kestrel, bozuk HTTP başlıkları konusunda daha katıdır. Ve SQL bağlantı dizeniz Entra ID (
Active Directory) kimlik doğrulaması kullanıyorsa, artıkMicrosoft.Data.SqlClient.Extensions.Azurepaketine ihtiyacınız var, bu aynı zamanda EF Core SQL Server kullanıcılarını da kapsar. - Uzantılar ve barındırma. Çalışan hizmetler daha yüksek sesle başarısız olur: Eğer bir
BackgroundServiceatarsa, ana bilgisayar da atar, bu yüzden başlangıç yolunuzu test edin. - Çekirdek kütüphaneler.
Math.Roundve karmaşık sayılar daha standartlara uygun hale geldi, bu sadece testlerin eski değerleri beklemesi durumunda önemlidir. - Derleme ve araçlar. VSTest Newtonsoft.Json'u bırakıyor, şablon paketleri netstandard2.0'ı bırakıyor. Bunlar derleme hatası olarak ortaya çıkar, bu yüzden kendilerini duyururlar.
- Platform. Minimum CPU gereksinimleri arttı, .NET MAUI Android API 24'e ihtiyaç duyuyor ve TLS sunucu tarafı sertifika alma varsayılan olarak kapalı. Bunların sizinle ilgili olup olmadığını bileceksiniz.
Endişelenmenize gerek olmayan bir şey
.NET 11 uyumluluğu için bağımlılıkları denetlerken, belge araçlarınız listenizde olmamalıdır. Iron Suite kütüphaneleri saf yönetilen .NET'tir ve zaten .NET 11'den .NET Framework'e kadar çalışır, bu yüzden IronPDF, IronXL ve diğer tüm paketler uygulamanızla birlikte hareket eder, onu engellemez. Yukarıdaki ZIP değişikliğinin, bu kütüphanelerin yerine geçtiği türden dosya işleme kodlarının hemen yanında yer aldığını belirtmekte fayda var, eğer el yapımı belge veya arşiv tesisatınız varsa, bir geçiş, bu kısmı zaten her .NET sürümünü takip eden bir kütüphaneye devretmek için doğal bir andır.
Kendi sayfasında yer alan ASP.NET Core değişiklikleri de dahil olmak üzere tam liste için, Microsoft .NET 11 önemli değişiklikler referansı yer imlerine eklemeniz gereken kaynaktır. Bu liste hala dolmakta olduğu için, bu gönderiyi liste büyüdükçe güncelleyeceğiz.