| Property | Value |
|---|---|
| 규칙 아이디 | CA1516 |
| Title | 플랫폼 간 내장 함수 사용 |
| Category | Maintainability |
| 수정 사항이 문제를 해결하고 있는지 혹은 새로운 문제를 일으키지 않는지 여부 | Non-breaking |
| .NET 10에서 기본적으로 사용하도록 설정 | No |
Cause
플랫폼 간 해당 항목이 있는 경우 플랫폼 또는 아키텍처 관련 내장 함수가 사용됩니다.
규칙 설명
이 규칙은 동일한 플랫폼 간 내장 함수로 대체할 수 있는 플랫폼별 내장 함수의 사용을 검색합니다.
위반을 해결하는 방법
코드를 전환하는 해결 프로그램을 적용하여 동등한 플랫폼 간 내장 함수를 사용합니다.
Example
다음 코드 조각은 CA1516의 세 가지 유사한 위반을 보여 줍니다.
using System;
using System.Runtime.Intrinsics;
using System.Runtime.Intrinsics.Arm;
using System.Runtime.Intrinsics.Wasm;
using System.Runtime.Intrinsics.X86;
class C
{
Vector128<byte> M1(Vector128<byte> x, Vector128<byte> y) => AdvSimd.Add(x, y);
Vector128<byte> M2(Vector128<byte> x, Vector128<byte> y) => Sse2.Add(x, y);
Vector128<byte> M3(Vector128<byte> x, Vector128<byte> y) => PackedSimd.Add(x, y);
}
다음 코드 조각은 위반을 수정하고 해결사에서 적용합니다.
using System;
using System.Runtime.Intrinsics;
class C
{
Vector128<byte> M1(Vector128<byte> x, Vector128<byte> y) => x + y;
Vector128<byte> M2(Vector128<byte> x, Vector128<byte> y) => x + y;
Vector128<byte> M3(Vector128<byte> x, Vector128<byte> y) => x + y;
}
수정 사항이 적용되면 모든 플랫폼에서 작동하는 단일 메서드로 세 가지 메서드를 간소화할 수 있다는 것이 더 분명해집니다.
경고를 표시하지 않는 경우
코드의 유지 관리가 중요하지 않은 경우 이 규칙의 위반을 표시하지 않아도 됩니다.
경고 표시 안 함
단일 위반을 억제하려면 소스 파일에 전처리기 지시문을 추가하여 규칙을 비활성화한 다음 다시 활성화하세요.
#pragma warning disable CA1516
// The code that's violating the rule is on this line.
#pragma warning restore CA1516
파일, 폴더 또는 프로젝트에 대한 규칙을 비활성화하려면 none에서 해당 심각도를 로 설정하세요.
[*.{cs,vb}]
dotnet_diagnostic.CA1516.severity = none
자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.
분석할 코드 구성
이 규칙을 적용할 출력 어셈블리 종류를 구성할 수 있습니다. 예를 들어 콘솔 애플리케이션이나 동적 연결 라이브러리(UI 앱이 아님)를 생성하는 코드에만 이 규칙을 적용하려면 프로젝트의 .editorconfig 파일에 다음 키-값 쌍을 추가합니다.
dotnet_code_quality.CA1516.output_kind = ConsoleApplication, DynamicallyLinkedLibrary
자세한 내용은 output_kind 참조하세요.
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET