CA1872: 'BitConverter.ToString'을 기반으로 하는 호출 체인보다 'Convert.ToHexString' 및 'Convert.ToHexStringLower' 선호

	값
규칙 ID	CA1872
제목	기준 통화 체인 선호 Convert.ToHexString 및 Convert.ToHexStringLower 이상 BitConverter.ToString
범주	성능
수정 사항이 주요 변경인지 여부	주요 변경 아님
.NET 9에서 기본적으로 사용	제안 사항

원인

대시를 제거하기 위한 BitConverter.ToString String.Replace 호출 뒤에 호출은 바이트를 16진수 문자열 표현으로 인코딩하는 데 사용됩니다. 이 규칙은 호출 체인에서 사용되는 경우에도 String.ToLower 발생합니다.

규칙 설명

바이트를 16진수 문자열 표현으로 인코딩하는 경우 또는 Convert.ToHexStringLower 사용합니다Convert.ToHexString. 이러한 메서드는 대시 String.ToLower및 를 제거하는 데 함께 String.Replace 사용하는 BitConverter.ToString 것보다 더 효율적이고 할당 친화적입니다.

위반 문제를 해결하는 방법

이 규칙 위반 문제를 해결하려면 호출 체인을 둘 중 하나 Convert.ToHexString 또는 Convert.ToHexStringLower.로 바꿉다.

예시

다음 코드 조각은 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

다음 코드 조각은 이 위반을 해결합니다.

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

경고를 표시하지 않는 경우

이 규칙에서 경고를 표시하지 않는 것이 안전합니다. 그러나 두 가지 중 하나를 Convert.ToHexString Convert.ToHexStringLower사용하는 것이 좋습니다.

경고 표시 안 함

단일 위반만 표시하지 않으려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 사용하지 않도록 설정한 후 다시 사용하도록 설정합니다.

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

파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않도록 설정하려면 구성 파일에서 심각도를 none으로 설정합니다.

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

자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.