CA1870: Uso de una instancia de "SearchValues" almacenada en caché

Causa

Se llama a un método IndexOfAny o ContainsAny con muchos valores constantes de una manera que pueda beneficiarse de usar SearchValues en su lugar.

La regla no marca las llamadas que usan hasta cinco valores, ya que estas ya usan una implementación óptima.

Descripción de la regla

El uso de una instancia de caché SearchValues<T> es más eficaz que pasar valores a IndexOfAny o ContainsAny directamente.

Cómo corregir infracciones

Cree y almacene en caché una instancia de SearchValues<T> en un campo de static readonly y, a continuación, pase esa instancia a la llamada IndexOfAny o ContainsAny en su lugar.

Hay disponible un solucionador de código que realiza esta transformación.

Ejemplo

En el siguiente fragmento de código se muestran dos infracciones de la regla CA1870:

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");
}

El siguiente fragmento de código corrige las infracciones:

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);
}

Si hay varias llamadas a IndexOfAny con el mismo conjunto de valores, se debe reutilizar s_myValues.

Cuándo suprimir las advertencias

Es seguro suprimir esta advertencia si el rendimiento no es un problema.

Supresión de una advertencia

Si solo quiere suprimir una única infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

#pragma warning disable CA1870
// The code that's violating the rule is on this line.
#pragma warning restore CA1870

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none del archivo de configuración.

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

Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.