CA1834: 단일 문자열에 StringBuilder.Append(char) 사용

원인

이 규칙은 단위 길이 문자열이 Append 메서드에 전달될 때 발생합니다.

규칙 설명

단위 길이 문자열을 사용하여 StringBuilder.Append를 호출할 때 성능을 향상하려면 단위 길이 const char 대신 const string를 사용하는 것이 좋습니다.

위반 문제를 해결하는 방법

위반은 수동으로 해결하거나, 경우에 따라 바로 가기를 사용하여 Visual Studio에서 코드를 수정할 수 있습니다. 예:

예 1

단위 길이의 문자열 리터럴을 사용하여 StringBuilder.Append 호출:

using System;
using System.Text;

namespace TestNamespace
{
    class TestClass
    {
        private void TestMethod()
        {
            StringBuilder sb = new StringBuilder();
            sb.Append("a");
        }
    }
}

Visual Studio에서 적용되는 수정 사항:

using System;
using System.Text;

namespace TestNamespace
{
    class TestClass
    {
        private void TestMethod()
        {
            StringBuilder sb = new StringBuilder();
            sb.Append('a');
        }
    }
}

단위 길이 const string 클래스 필드를 사용하는 경우처럼 경우에 따라 코드 수정 사항이 Visual Studio에서 제안되지 않지만 분석기는 여전히 발생합니다. 이러한 인스턴스는 수동으로 수정해야 합니다.

예제 2

단위 길이의 StringBuilder.Append 클래스 필드를 사용하여 const string 호출:

using System;
using System.Text;

namespace TestNamespace
{
    public class Program
    {
        public const string unitString = "a";

        static void Main(string[] args)
        {
            StringBuilder sb = new StringBuilder();
            sb.Append(unitString);
        }
    }
}

신중하게 분석한 후 빌드 오류를 발생시키지 않고 unitString을 char로 변경할 수 있습니다.

using System;
using System.Text;

namespace TestNamespace
{
    public class Program
    {
        public const char unitString = 'a';

        static void Main(string[] args)
        {
            StringBuilder sb = new StringBuilder();
            sb.Append(unitString);
        }
    }
}

경고를 표시하지 않는 경우

StringBuilder를 사용할 때 성능 향상이 중요하지 않은 경우 이 규칙의 위반을 표시하지 않아도 됩니다.

경고 표시 안 함

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

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

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

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

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

참고 항목

• 성능 규칙