CA1830: StringBuilder에서 강력한 형식의 Append 및 Insert 메서드 오버로드를 선호합니다.

속성	값
규칙 ID	CA1830
제목	StringBuilder에서 강력한 형식의 추가 및 삽입 메서드 오버로드를 사용하세요.
범주	성능
수정 사항이 주요 변경인지 여부	주요 변경 아님
.NET 9에서 기본적으로 사용	제안 사항

원인

Append 또는 Insert 메서드에 전용 오버로드가 있는 형식에서 ToString을 호출한 결과인 인수를 사용하여 StringBuilder Append 또는 Insert 메서드가 호출되었습니다.

규칙 설명

Append 및 Insert는 String 이외의 여러 형식에 대한 오버로드를 제공합니다. 가능하면 ToString() 및 문자열 기반 오버로드를 사용하는 대신 강력한 형식의 오버로드를 사용하는 것이 좋습니다.

위반 문제를 해결하는 방법

호출에서 불필요한 ToString()을 삭제합니다.

using System.Text;

class C
{
    int _value;

    // Violation
    public void Log(StringBuilder destination)
    {
        destination.Append("Value: ").Append(_value.ToString()).AppendLine();
    }

    // Fixed
    public void Log(StringBuilder destination)
    {
        destination.Append("Value: ").Append(_value).AppendLine();
    }
}

경고를 표시하지 않는 경우

불필요한 문자열 할당이 성능에 미치는 영향을 고려하지 않아도 되는 경우 이 규칙의 위반을 표시하지 않아도 됩니다.

경고 표시 안 함

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

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

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

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

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

참고 항목

• 성능 규칙