CA1870: Önbelleğe alınmış bir 'SearchValues' örneği kullanın

Özellik	Değer
Kural Kimliği	CA1870
Başlık	Önbelleğe alınmış bir 'SearchValues' örneği kullanma
Kategori	Performans
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 10'da varsayılan olarak etkin	Öneri olarak

Neden

Bir IndexOfAny veya ContainsAny yöntemi, bunun yerine kullanmaktan SearchValues yararlanabilecek şekilde birçok sabit değerle çağrılır.

Kural, en fazla beş değer kullanan çağrıları bayrakla işaretlemez çünkü bunlar zaten en uygun uygulamayı kullanır.

Kural açıklaması

Önbelleğe alınmış SearchValues<T> örnek kullanmak, değerleri IndexOfAny doğrudan veya ContainsAny doğrudan geçirmekten daha verimlidir.

İhlalleri düzeltme

Bir alandaki örneği SearchValues<T> oluşturup önbelleğe alınstatic readonly, ardından bu örneği veya IndexOfAny çağrısına ContainsAny geçirin.

Bu dönüşümü otomatik olarak gerçekleştiren kod düzeltmesi kullanılabilir.

Örnek

Aşağıdaki kod parçacığı ca1870'in iki ihlalini gösterir:

static readonly char[] MyValues = new[] { 'a', 'b', 'c', 'x', 'y', 'z' };

static int IndexOfMyValues(ReadOnlySpan<char> text)
{
    return text.IndexOfAny(MyValues);
}

static bool ContainsOnlyMyValues(ReadOnlySpan<char> text)
{
    return !text.ContainsAnyExcept("abcxyz");
}

Aşağıdaki kod parçacığı ihlalleri düzeltir:

private static readonly SearchValues<char> s_myValues = SearchValues.Create("abcxyz");

static int IndexOfMyValues(ReadOnlySpan<char> text)
{
    return text.IndexOfAny(s_myValues);
}

static bool ContainsOnlyMyValues(ReadOnlySpan<char> text)
{
    return !text.ContainsAnyExcept(s_myValues);
}

Aynı değer kümesine sahip birden çok çağrısı IndexOfAny varsa yeniden s_myValues kullanılmalıdır.

Uyarıların ne zaman bastırılması gerekiyor?

Performansla ilgili bir sorun yoksa bu uyarıyı bastırmak 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 CA1870
// The code that's violating the rule is on this line.
#pragma warning restore CA1870

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1870.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bakınız

• MemoryExtensions.AsSpan.IndexOfAny ve SearchValues<T> türü