CA1311: 문화권 지정 또는 고정 버전 사용
속성 | 값 |
---|---|
규칙 ID | CA1311 |
제목 | 문화권 지정 또는 고정 버전 사용 |
범주 | 전역화 |
수정 사항이 주요 변경인지 여부 | 주요 변경 아님 |
.NET 9에서 기본적으로 사용 | 아니요 |
원인
문화권을 지정하지 않고 String.ToUpper() 또는 String.ToLower()에 대한 호출이 수행됩니다.
규칙 설명
문화권을 지정하거나 고정 문화권을 사용하여 ToUpper
또는 ToLower
를 호출할 때 현재 문화권에 대한 암시적 종속성을 방지합니다. 고정 문화권을 사용하면 애플리케이션의 문화권에 관계없이 일관된 결과가 생성됩니다.
위반 문제를 해결하는 방법
매개 변수가 없는 String.ToUpper() 또는 String.ToLower() 메서드를 호출하는 대신 ToUpper(CultureInfo) 또는 ToUpperInvariant()나 ToLower(CultureInfo) 또는 ToLowerInvariant()를 호출합니다.
예
다음 코드 조각은 CA1311의 위반을 보여 줍니다.
string s = "hello";
s = s.ToLower();
Dim s As String = "hello"
s.ToLower()
다음 코드 조각은 이 위반을 해결합니다.
string s = "hello";
s = s.ToLowerInvariant();
Dim s As String = "hello"
s.ToLowerInvariant()
경고를 표시하지 않는 경우
Thread.CurrentCulture가 변경되지 않을 것이 확실한 경우 이 규칙의 경고를 표시하지 않는 것이 안전합니다.
경고 표시 안 함
단일 위반만 표시하지 않으려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 사용하지 않도록 설정한 후 다시 사용하도록 설정합니다.
#pragma warning disable CA1311
// The code that's violating the rule is on this line.
#pragma warning restore CA1311
파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않도록 설정하려면 구성 파일에서 심각도를 none
으로 설정합니다.
[*.{cs,vb}]
dotnet_diagnostic.CA1311.severity = none
자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.
추가 정보
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET