CA1833: Usar AsSpan o AsMemory en lugar de indizadores basados en intervalos para obtener la parte Span o Memory de una matriz

Propiedad	Valor
Identificador de la regla	CA1833
Título	Usar AsSpan o AsMemory en lugar de indizadores basados en intervalos para obtener la parte Span o Memory de una matriz
Categoría	Rendimiento
La corrección interrumpe o no interrumpe	Sin interrupción
Habilitado de forma predeterminada en .NET 10	Como sugerencia
Idiomas aplicables	C# y Visual Basic

Causa

Al usar un indizador de intervalo en una matriz y asignar implícitamente el valor a Span<T> o Memory<T>.

Descripción de la regla

El indexador de intervalos de un Span<T> es una operación Slice sin copia. Pero para el indexador de intervalo en una matriz, el método GetSubArray se usará en lugar de Slice, que genera una copia de la parte solicitada de la matriz. Esta copia no suele ser necesaria cuando se usa implícitamente como valor Span<T> o Memory<T>. Si no se pretende obtener una copia, use el método AsSpan o AsMemory para evitar la copia innecesaria. Si se pretende obtener la copia, asígnela primero a una variable local o agregue una conversión explícita. El analizador solo informa cuando se realiza una conversión implícita en el resultado de la operación del indexador de rango.

Detecta

Conversiones implícitas:

• Span<SomeT> slice = arr[a..b];
• Memory<SomeT> slice = arr[a..b];

No detecta

Conversiones explícitas:

• Span<SomeT> slice = (Span<SomeT>)arr[a..b];
• Memory<SomeT> slice = (Memory<SomeT>)arr[a..b];

Cómo corregir infracciones

Para corregir una infracción de esta regla, use el método de extensión AsSpan o AsMemory para evitar la creación de copias de datos innecesarias.

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation occurs for both statements below
        Span<byte> tmp2 = arr[0..5];
        Memory<byte> tmp4 = arr[5..10];
        ...
    }
}

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violations fixed with AsSpan or AsMemory accordingly
        Span<byte> tmp2 = arr.AsSpan()[0..5];
        Memory<byte> tmp4 = arr.AsMemory()[5..10];
        ...
    }
}

Sugerencia

Hay disponible una corrección de código para esta regla en Visual Studio. Para usarlo, coloque el cursor sobre la infracción y presione Ctrl+. (punto). Elija Usar AsMemory en lugar de indizadores basados en intervalos para una matriz en la lista de opciones que se muestra.

También puede evitar esta advertencia mediante la adición de una conversión explícita.

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation occurs
        Span<byte> tmp1 = arr[0..5];
        Memory<byte> tmp2 = arr[5..10];
        ...
    }
}

class C
{
    public void TestMethod(byte[] arr)
    {
        // The violation fixed with explicit casting
        Span<byte> tmp1 = (Span<byte>)arr[0..5];
        Memory<byte> tmp2 = (Memory<byte>)arr[5..10];
        ...
    }
}

Cuándo suprimir las advertencias

Se puede suprimir una infracción de esta regla si la creación de una copia es intencional.

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 CA1833
// The code that's violating the rule is on this line.
#pragma warning restore CA1833

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.CA1833.severity = none

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

Reglas relacionadas

• CA1831: Usar AsSpan en lugar de indizadores basados en intervalos para una cadena cuando proceda
• CA1832: Usar AsSpan o AsMemory en lugar de indizadores basados en intervalos para obtener la parte ReadOnlySpan o ReadOnlyMemory de una matriz

Vea también

• Reglas de rendimiento