CA1870: Uso de una instancia de "SearchValues" almacenada en caché
| Propiedad | Value |
|---|---|
| Identificador de la regla | CA1870 |
| Título | Uso de una instancia de "SearchValues" almacenada en caché |
| Categoría | Rendimiento |
| La corrección es problemática o no problemática | Poco problemático |
| Habilitado de forma predeterminada en .NET 9 | Como sugerencia |
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.
