Performans kuralları

Performans kuralları yüksek performanslı kitaplıkları ve uygulamaları destekler.

Bu bölümde

Kural Açıklama
CA1802: Uygun Yerlerde Değişmez Değerleri Kullanma Alan statik ve salt okunur olarak bildirilir (Visual Basic'te Paylaşılan ve Salt Okunur) ve derleme zamanında hesaplamalı bir değerle başlatılır. Hedeflenen alana atanan değer derleme zamanında hesaplanabilir olduğundan, değerin çalışma zamanı yerine derleme zamanında hesaplanabilmesi için bildirimi bir const (Visual Basic'te Const) alanıyla değiştirin.
CA1805: Gereksiz yere başlatmayın .NET çalışma zamanı, oluşturucuyu çalıştırmadan önce başvuru türlerinin tüm alanlarını varsayılan değerlerine başlatır. Çoğu durumda, bir alanı varsayılan değeriyle açıkça başlatmak gereksizdir; bu, bakım maliyetlerini artırır ve performansı olumsuz etkileyebilir (örneğin, derleme boyutunun artması gibi).
CA1806: Yöntem sonuçlarını yoksaymayın Yeni bir nesne oluşturulur ancak hiçbir zaman kullanılmaz ya da yeni dize oluşturup döndüren bir yöntem çağrılır ve yeni dize hiçbir zaman kullanılmaz ya da Bileşen Nesne Modeli (COM) veya P/Invoke yöntemi hresult veya hiç kullanılmayan bir hata kodu döndürür.
CA1810: Satır içi başvuru tipi statik alanlarını başlatma Bir tür açıkça tanımlanmış bir statik kurucu bildirdiğinde, tam zamanında (JIT) derleyici, statik kurucunun daha önce çağrılmış olduğundan emin olmak için türün her statik yöntemine ve örnek oluşturucusuna bir denetim ekler. Statik oluşturucu denetimleri performansı düşürebilir.
CA1812: Örneği oluşturulmamış iç sınıflardan kaçının Derleme düzeyindeki bir türün örneği, derlemedeki kod tarafından oluşturulmaz.
CA1813: Sealed olmayan özniteliklerden kaçının .NET, özel öznitelikleri almak için yöntemler sağlar. Varsayılan olarak, bu yöntemler öznitelik devralma hiyerarşisinde arama yapar. Öznitelik mühürleme kalıtım hiyerarşisi aracılığıyla aramayı ortadan kaldırır ve performansı artırabilir.
CA1814: Çok boyutlu yerine pürüzlü dizileri tercih edin Düzensiz dizi, elemanları da dizi olan bir dizidir. Öğeleri oluşturan diziler farklı boyutlarda olabilir ve bu da bazı veri kümeleri için daha az boş alan kaybına neden olabilir.
CA1815: Değer türlerinde Equals ve eşittir işlecini geçersiz kılma Değer türleri için, Equals'ın devralınmış uygulaması Reflection kitaplığını kullanır ve türdeki tüm alanların içeriğini karşılaştırır. Yansıma hesaplama açısından maliyetlidir ve her alanın eşitliğini karşılaştırmak gereksiz olabilir. Kullanıcıların örnekleri karşılaştırmasını veya sıralamasını ya da örnekleri karma tablosu anahtarı olarak kullanmasını bekliyorsanız, değer türünüz Equals yöntemini uygulamalıdır.
CA1819: Özellikler dizi döndürmemelidir Özellik salt okunur olsa bile, bir özelliğin döndürdüğü diziler yazma korumalı değildir. Dizinin kurcalamaya karşı korumalı kalması için, özelliğin dizinin bir kopyasını döndürmesi gerekir. Tipik olarak kullanıcılar, böyle bir özelliği çağırmanın olumsuz performans etkilerini anlamaz.
CA1820: Dize uzunluğunu kullanarak boş dizeleri test edin Dizeleri String.Length özelliğini veya String.IsNullOrEmpty yöntemini kullanarak karşılaştırmak, Equals kullanmaktan önemli ölçüde daha hızlıdır.
CA1821: Boş sonlandırıcıları kaldırma Mümkün olduğunda, nesnenin yaşam döngüsünü izlemenin getirdiği ek performans yükü nedeniyle sonlandırıcıları kullanmaktan kaçının. Boş bir sonlandırıcı, hiçbir fayda sağlamadan ek yük getirir.
CA1822: Üyeleri statik olarak işaretleme Örnek verilerine erişmeyen veya örnek yöntemlerini çağırmayan üyeler statik olarak işaretlenebilir (Visual Basic'te paylaşılan). Yöntemleri statik olarak işaretledikten sonra derleyici, bu üyeler için sanal olmayan çağrı noktaları oluşturur. Bu, performansa duyarlı kodlar için ölçülebilir bir performans artışı sağlayabilir.
CA1823: Kullanılmayan özel alanlardan kaçının Derlemede erişimi görülmeyen özel alanlar algılandı.
CA1824: Derlemeleri NeutralResourcesLanguageAttribute ile işaretleyin NeutralResourcesLanguage özniteliği, Resource Manager'a bir derleme için nötr kültürün kaynaklarını görüntülemek için kullanılan dili bildirir. Bu ilk yüklediğiniz kaynak için arama performansını artırır ve çalışma kümenizi azaltabilir.
CA1825: Sıfır uzunluklu dizi ayırmalarından kaçının Sıfır uzunluklu bir dizinin başlatılması gereksiz bellek ayırmaya neden olur. Bunun yerine çağırarak Array.Emptystatik olarak ayrılmış boş dizi örneğini kullanın. Bellek ayırma, bu yöntemin tüm çağrılarında paylaşılır.
CA1826: Linq Enumerable yöntemi yerine özelliği kullanın Enumerable LINQ yöntemi, eşdeğer, daha verimli bir property'sini destekleyen bir tür üzerinde kullanıldı.
CA1827: Any kullanılabildiğinde Count/LongCount kullanmayın Any yöntemi daha verimli olacakken Count veya LongCount yöntemi kullanıldı.
CA1828: AnyAsync kullanılabildiğinde CountAsync/LongCountAsync kullanmayın AnyAsync yönteminin daha verimli olacağı bir durumda CountAsync veya LongCountAsync yöntemi kullanıldı.
CA1829: Enumerable.Count yöntemi yerine Length/Count özelliğini kullanın Count LINQ yöntemi eşdeğer, daha verimli Length veya Count özelliği destekleyen bir tür üzerinde kullanılmıştır.
CA1830: StringBuilder üzerinde güçlü tür atanmış Append ve Insert yöntem aşırı yüklemelerini tercih edin Append ve Insert System.String dışında birden çok tür için aşırı yüklemeler sağlar. Mümkün olduğunda, ToString() kullanımı ve dize tabanlı aşırı yükleme yerine güçlü türlendirilmiş aşırı yüklemeleri tercih edin.
CA1831: Uygun olduğunda dize için Aralık tabanlı dizin oluşturucular yerine AsSpan kullanın Bir dize üzerinde aralık dizinleyicisi kullanırken ve değer örtük olarak ReadOnlySpan<char> türüne atanırken, dizenin istenen bölümünün bir kopyasını üreten Slice yerine Substring yöntemi kullanılır.
CA1832: Bir dizinin ReadOnlySpan veya ReadOnlyMemory bölümünü almak için Aralık tabanlı dizin oluşturucular yerine AsSpan veya AsMemory kullanın Bir dizide aralık dizinleyicisi kullanıldığında ve değer örtük olarak bir ReadOnlySpan<T> veya ReadOnlyMemory<T> türüne atandığında, dizinin istenen bölümünün bir kopyasını oluşturan Slice yerine GetSubArray yöntemi kullanılır.
CA1833: Bir dizinin Span veya Memory bölümünü almak için Aralık tabanlı dizin oluşturucular yerine AsSpan veya AsMemory kullanın Bir dizide aralık dizinleyicisi kullanıldığında ve değer örtük olarak bir Span<T> veya Memory<T> türüne atandığında, dizinin istenen bölümünün bir kopyasını oluşturan Slice yerine GetSubArray yöntemi kullanılır.
CA1834: Tek karakterli dizeler için StringBuilder.Append(char) kullanın StringBuilder, bağımsız değişken olarak bir char alan Append aşırı yüklemesine sahiptir. Performansı geliştirmek için aşırı yüklemeyi çağırmayı char tercih edin.
CA1835: 'ReadAsync' ve 'WriteAsync' için 'Memory' tabanlı aşırı yüklemeleri tercih edin 'Stream', ilk bağımsız değişken olarak 'Memory<Byte>' alan bir 'ReadAsync' aşırı yüklemesine ve ilk bağımsız değişken olarak 'ReadOnlyMemory<Byte>' alan bir 'WriteAsync' aşırı yüklemesine sahiptir. Daha verimli olan bellek tabanlı aşırı yüklemeleri çağırmayı tercih edin.
CA1836: Kullanılabiliyorsa Count yerine IsEmpty tercih edin Nesnenin herhangi bir öğe içerip içermediğini belirlemek için, Count, Length, Count<TSource>(IEnumerable<TSource>) veya LongCount<TSource>(IEnumerable<TSource>) yerine daha verimli olan IsEmpty özelliğini tercih edin.
CA1837: Process.GetCurrentProcess().Id yerine Environment.ProcessId kullanın Environment.ProcessId, Process.GetCurrentProcess().Id'den daha basit ve daha hızlıdır.
CA1838: P/Invokes için StringBuilder parametrelerinden kaçının StringBuilder öğesinin marshalling işlemi her zaman yerel bir arabellek kopyası oluşturur; bu da tek bir marshalling işlemi için birden fazla ayırmaya neden olur.
CA1839: Process.GetCurrentProcess().MainModule.FileName yerine Environment.ProcessPath kullanın Environment.ProcessPath , Process.GetCurrentProcess().MainModule.FileName değerinden daha basit ve daha hızlıdır.
CA1840: Thread.CurrentThread.ManagedThreadId yerine Environment.CurrentManagedThreadId kullanın Environment.CurrentManagedThreadId, Thread.CurrentThread.ManagedThreadId değerinden daha kompakt ve verimlidir.
CA1841: Sözlük Contains yöntemlerini tercih edin Keys veya Values koleksiyonunda Contains çağrısı yapmak, çoğu zaman sözlüğün kendisinde ContainsKey veya ContainsValue çağrısı yapmaktan daha maliyetli olabilir.
CA1842: 'WhenAll'ı tek bir görevle kullanmayın Tek bir görevle kullanmak WhenAll performans kaybına neden olabilir. Bunun yerine görevin tamamlanmasını bekleyin veya görevi döndürün.
CA1843: Tek bir görevle 'WaitAll' kullanmayın Tek bir görevle kullanmak WaitAll performans kaybına neden olabilir. Bunun yerine görevin tamamlanmasını bekleyin veya görevi döndürün.
CA1844: 'Stream'den türetilen bir alt sınıf oluştururken zaman uyumsuz yöntemlerin bellek tabanlı geçersiz kılmalarını sağlayın Performansı geliştirmek için 'Stream' alt sınıfını oluştururken bellek tabanlı zaman uyumsuz yöntemleri geçersiz kılın. Ardından dizi tabanlı yöntemleri bellek tabanlı yöntemler açısından uygulayın.
CA1845: Span tabanlı 'string.Concat' kullanın Substring ve birleştirme işleci yerine AsSpan ve string.Concat kullanmak daha verimlidir.
CA1846: Substring yerine AsSpan tercih edin AsSpan, Substring'den daha verimlidir. Substring bir O(n) dize kopyası gerçekleştirir, ancak AsSpan gerçekleştirmez ve sabit bir maliyeti vardır. AsSpan ayrıca herhangi bir yığın ayırması gerçekleştirmez.
CA1847: Tek karakterli arama için karakter değişmez değeri kullanma Tek bir karakter aramak yerine String.Contains(char) kullanınString.Contains(string).
CA1848: LoggerMessage temsilcilerini kullanın Daha iyi performans için LoggerMessage temsilcilerini kullanın.
CA1849: Async bir yöntemdeyken async yöntemleri çağırın Zaten asenkron olan bir yöntemde, diğer yöntem çağrıları varsa bunların asenkron sürümlerine yapılmalıdır.
CA1850: ComputeHash yerine statik HashData yöntemi tercih edin ComputeHash çağırmak için HashAlgorithm örneği oluşturup yönetmek yerine statik HashData yöntemini kullanmak daha verimlidir.
CA1851: IEnumerable koleksiyonunun birden çok kez yinelenmesi olasıdır IEnumerable koleksiyonu üzerinde birden çok kez yineleme yapılması olası. Birden çok numaralandırmayı önleyen bir uygulama kullanmayı göz önünde bulundurun.
CA1852: İç türleri mühürleme Derlemesi dışında erişilmeyen ve içeren derleme içinde alt türü olmayan bir tür mühürlenmez.
CA1853: 'Dictionary.ContainsKey(key)' için gereksiz çağrı Dictionary.Remove(key) öğesini Dictionary.ContainsKey(key) ile korumaya gerek yoktur. Dictionary<TKey,TValue>.Remove(TKey) zaten anahtarın var olup olmadığını denetler ve yoksa hata fırlatmaz.
CA1854: 'IDictionary.TryGetValue(TKey, out TValue)' yöntemini tercih edin 'ContainsKey' denetimiyle korunan bir Sözlük dizin oluşturucu erişimi yerine 'TryGetValue' seçeneğini tercih edin. Hem 'ContainsKey' hem de dizin oluşturucu anahtarı arar, bu nedenle 'TryGetValue' kullanıldığında ek arama engellenir.
CA1855: Span<T>.Fill() yerine Span<T>.Clear() kullanın Span içindeki öğeleri varsayılan bir değerle doldurmak için Span<T>.Fill(T) çağırmaktansa Span<T>.Clear() çağırmak daha verimlidir.
CA1856: ConstantExpected özniteliğinin yanlış kullanımı ConstantExpectedAttribute Özniteliği bir parametreye doğru uygulanmadı.
CA1857: Parametre, en iyi performans için bir sabit bekler ConstantExpectedAttribute ile açıklama eklenmiş bir parametreye geçersiz bir argüman iletilir.
CA1858: IndexOf yerine StartsWith kullanın Bir dizenin belirli bir ön ekle başlayıp başlamadığını denetlemek için String.IndexOf çağırmaktansa String.StartsWith çağırmak daha verimlidir.
CA1859: Gelişmiş performans için mümkün olduğunda somut türler kullanın Kod, arabirim türlerini veya soyut türleri kullanarak gereksiz arabirim çağrılarına veya sanal çağrılara yol açar.
CA1860: 'Enumerable.Any()' uzantı yöntemini kullanmaktan kaçının Bir koleksiyon türünün herhangi bir öğe içerip içermediğini belirlemek için Enumerable.Any çağırmak yerine, Length, Count veya IsEmpty kullanmak (mümkünse) daha verimli ve daha açıktır.
CA1861: Bağımsız değişken olarak sabit dizilerden kaçının Argüman olarak geçirilen sabit diziler yeniden kullanılmaz; bu da performans yüküne neden olur. Performansı artırmak için bunları 'static readonly' alanlarına taşımayı düşünebilirsiniz.
CA1862: Büyük/küçük harfe duyarlı olmayan dize karşılaştırmaları gerçekleştirmek için 'StringComparison' yöntemi aşırı yüklemelerini kullanın Kod, büyük/küçük harf duyarsız bir dize karşılaştırması gerçekleştirmek için ToLower() veya ToUpper() çağırdığında, gereksiz bir bellek ayırma yapılır.
CA1863: 'CompositeFormat' kullanın Biçimlendirme maliyetini azaltmak için, String.Format veya StringBuilder.AppendFormat için argüman olarak bir CompositeFormat örneğini önbelleğe alın ve kullanın.
CA1864: 'Dictionary.TryAdd(TKey, TValue)' yöntemini tercih edin Hem Dictionary<TKey,TValue>.ContainsKey(TKey) hem de Dictionary<TKey,TValue>.Add arama yapar; bu gereksizdir. Dictionary<TKey,TValue>.TryAdd çağırmak daha verimlidir. Bu, değerin eklenip eklenmediğini belirten bir bool değer döndürür. TryAdd anahtar zaten varsa anahtarın değerinin üzerine yazmaz.
CA1865-CA1867: char overload kullanın char aşırı yüklemesi, tek bir karakter içeren bir dize için daha iyi performans sunan bir aşırı yüklemedir.
CA1868: Kümeler için gereksiz 'Contains' çağrısı Hem ISet<T>.Add(T) hem de ICollection<T>.Remove(T) bir arama yapar; bu da ICollection<T>.Contains(T)’yi önceden çağırmayı gereksiz kılar. Öğenin eklenip eklenmediğini ya da kaldırılıp kaldırılmadığını belirten bir Boole değeri döndüren Add(T) veya Remove(T) öğesini doğrudan çağırmak daha verimlidir.
CA1869: 'JsonSerializerOptions' örneklerini önbelleğe alma ve yeniden kullanma System.Text.Json serileştirmeyle ilgili meta verileri sağlanan örnekte dahili olarak önbelleğe aldığı için, serileştirme veya seri durumdan çıkarma için yerel bir örneğinin JsonSerializerOptions kullanılması, kodunuz birden çok kez yürütülürse uygulamanızın performansını önemli ölçüde düşürebilir.
CA1870: Önbelleğe alınmış bir 'SearchValues' örneği kullanın Önbelleğe alınmış SearchValues<T> örnek kullanmak, değerleri doğrudan 'IndexOfAny' veya 'ContainsAny' öğesine geçirmekten daha verimlidir.
CA1871: 'ArgumentNullException.ThrowIfNull' yöntemine null atanabilir bir yapı geçirmeyin 'ArgumentNullException.ThrowIfNull' bir 'object' kabul eder, bu nedenle null atanabilir bir yapı geçirmek değerin kutulanmasına neden olabilir.
CA1872: 'BitConverter.ToString' tabanlı çağrı zincirleri yerine 'Convert.ToHexString' ve 'Convert.ToHexStringLower' tercih edin Baytları onaltılık dize gösterimine kodlarken Convert.ToHexString veya Convert.ToHexStringLower kullanın. Bu yöntemler, tireleri ve String.ToLower öğesini değiştirmek için BitConverter.ToString ile String.Replace birleşimini kullanmaktan daha verimli ve bellek ayırma açısından daha elverişlidir.
CA1873: Potansiyel olarak pahalı günlüğe kaydetmeden kaçının Günlüğe kaydetme yöntemleri çağrıldığında, günlük düzeyi etkinleştirilmiş olsun veya olmasın, bu yöntemlerin argümanları değerlendirilir. Bu, günlük iletisi yazılmasa bile pahalı işlemlerin yürütülmesine neden olabilir. Daha iyi performans için, pahalı loglama çağrılarını bir kontrol ile IsEnabled koruyun veya LoggerMessage desenini kullanın.
CA1874: 'Regex.IsMatch' kullanın Regex.IsMatch, Regex.Match(...).Success öğesinden daha basit ve daha hızlıdır.
CA1875: 'Regex.Count' kullanın Regex.Count, Regex.Matches(...).Count'den daha basit ve daha hızlıdır.
CA1876: 'foreach' içinde 'AsParallel' kullanmayın AsParallel() döngüsünde foreach doğrudan çağrılması, döngünün paralel olmasını sağlamaz. Her öğeyi paralel olarak işlemek için Parallel.ForEach kullanın.
CA1877: 'Path.Combine' veya 'Path.Join' aşırı yüklemelerini kullanın Birden çok ardışık Path.Combine veya Path.Join işlem, birden çok yol kesimini kabul eden aşırı yüklemeler kullanılarak tek bir çağrıya daraltılabilir.
CA1878: Salt okunur dizi alanları yerine ReadOnlySpan özelliklerini tercih edin Özel statik salt okunur sabit dizi alanı bir ReadOnlySpan<T> özellik ile değiştirilebilir, böylece C# derleyicisi yönetilen dizi ayırmasını önleyebilir.