CA1831: Uygun olduğunda dize için Aralık tabanlı dizin oluşturucular yerine AsSpan kullanın
Özellik | Değer |
---|---|
Kural Kimliği | CA1831 |
Başlık | Uygun olduğunda dize için Aralık tabanlı dizin oluşturucular yerine AsSpan kullanın |
Kategori | Performans |
Hataya neden olan veya bozulmayan düzeltme | Hataya neden olmayan |
.NET 8'de varsayılan olarak etkin | Uyarı olarak |
Neden
Bir dizede aralık dizin oluşturucu kullanılır ve değer örtük olarak öğesine ReadOnlySpan<char>
atanır.
Kural açıklaması
Bu kural, bir dizede aralık dizin oluşturucu kullandığınızda ve bunu bir span türüne atadığınızda tetiklenir. üzerindeki Span<T> aralık dizin oluşturucu kopyalanamayan Slice bir işlemdir, ancak bir dizedeki aralık dizin oluşturucu için yöntemi Substring yerine Slicekullanılır. Bu, dizenin istenen bölümünün bir kopyasını oluşturur. Bu kopya genellikle örtük olarak veya ReadOnlyMemory<T> değeri olarak kullanıldığında gereksizdirReadOnlySpan<T>. Bir kopya amaçlanmamışsa, gereksiz kopyayı önlemek için yöntemini kullanın AsSpan . Kopya amaçlanıyorsa, önce yerel bir değişkene atayın veya açık bir atama ekleyin. Çözümleyici yalnızca aralık dizin oluşturucu işleminin sonucu üzerinde örtük bir atama kullanıldığında bildirir.
Algı -lar
Örtük dönüştürme:
ReadOnlySpan<char> slice = str[a..b];
Algılanmaz
Açık dönüştürme:
ReadOnlySpan<char> slice = (ReadOnlySpan<char>)str[a..b];
İhlalleri düzeltme
Bu kuralın ihlalini düzeltmek için, gereksiz veri kopyaları oluşturmamak için dizedeki tabanlı dizin oluşturucu yerine RangekullanınAsSpan.
public void TestMethod(string str)
{
// The violation occurs
ReadOnlySpan<char> slice = str[1..3];
...
}
public void TestMethod(string str)
{
// The violation fixed with AsSpan extension method
ReadOnlySpan<char> slice = str.AsSpan()[1..3];
...
}
Bahşiş
Visual Studio'da bu kural için bir kod düzeltmesi kullanılabilir. Bunu kullanmak için imleci ihlalin üzerine getirin ve Ctrl+ tuşuna (nokta) basın. Sunulan seçenekler listesinden bir dizede Aralık tabanlı dizin oluşturucu yerine AsSpan Kullan'ı seçin.
Bu uyarıyı önlemek için açık bir atama da ekleyebilirsiniz.
public void TestMethod(string str)
{
// The violation occurs.
ReadOnlySpan<char> slice = str[1..3];
...
}
public void TestMethod(string str)
{
// The violation avoided with explicit casting.
ReadOnlySpan<char> slice = (ReadOnlySpan<char>)str[1..3];
...
}
Uyarıların ne zaman bastırılması gerekiyor?
Kopya oluşturmanın amacı bu kuralın ihlalini engellemek güvenlidir.
Uyarıyı gizleme
Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.
#pragma warning disable CA1831
// The code that's violating the rule is on this line.
#pragma warning restore CA1831
Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini none
olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.CA1831.severity = none
Bu kural kategorisinin tamamını devre dışı bırakmak için, kategorinin önem derecesini none
yapılandırma dosyasında olarak ayarlayın.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Performance.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.
İlgili kurallar
- 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
- 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