CA1872: Preferir 'Convert.ToHexString' y 'Convert.ToHexStringLower' en cadenas de llamadas basadas en 'BitConverter.ToString'

	Valor
Identificador de la regla	CA1872
Título	Se prefiere 'Convert.ToHexString' y 'Convert.ToHexStringLower' en cadenas de llamadas basadas en 'BitConverter.ToString'
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

Una llamada a BitConverter.ToString seguida de una llamada a String.Replace para quitar guiones se usa para codificar bytes en una representación de cadena hexadecimal. Esta regla también se activa si String.ToLower se usa en la cadena de llamadas.

Descripción de la regla

Use Convert.ToHexString o Convert.ToHexStringLower al codificar bytes en una representación de cadena hexadecimal. Estos métodos son más eficaces y fáciles de asignar que usar BitConverter.ToString en combinación con String.Replace para quitar guiones y String.ToLower.

Cómo corregir infracciones

Para corregir una infracción de esta regla, reemplace la cadena de llamadas por Convert.ToHexString o Convert.ToHexStringLower.

Ejemplo

El fragmento de código siguiente muestra una infracción de CA1872:

using System;
using System.Text;

class HelloWorldEncoder
{
    private readonly byte[] _data = Encoding.ASCII.GetBytes("Hello World");

    public string Encode()
    {
        return BitConverter.ToString(_data).Replace("-", "");
    }

    public string EncodeToLower()
    {
        return BitConverter.ToString(_data).Replace("-", "").ToLower();
    }
}

Imports System
Imports System.Text

Class HelloWorldEncoder
    Private ReadOnly _data As Byte() = Encoding.ASCII.GetBytes("Hello World")

    Public Function Encode() As String
        Return BitConverter.ToString(_data).Replace("-", "")
    End Function

    Public Function EncodeToLower() As String
        Return BitConverter.ToString(_data).Replace("-", "").ToLower()
    End Function
End Class

El siguiente fragmento de código corrige la infracción:

using System;
using System.Text;

class HelloWorldEncoder
{
    private readonly byte[] _data = Encoding.ASCII.GetBytes("Hello World");

    public string Encode()
    {
        return Convert.ToHexString(data);
    }

    public string EncodeToLower()
    {
        return Convert.ToHexStringLower(data);
    }
}

Imports System
Imports System.Text

Class HelloWorldEncoder
    Private ReadOnly _data As Byte() = Encoding.ASCII.GetBytes("Hello World")

    Public Function Encode() As String
        Return Convert.ToHexString(data)
    End Function

    Public Function EncodeToLower() As String
        Return Convert.ToHexStringLower(data)
    End Function
End Class

Cuándo suprimir las advertencias

Es seguro suprimir una advertencia de esta regla; sin embargo, se recomienda usar Convert.ToHexString o Convert.ToHexStringLower.

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

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

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