다음을 통해 공유


CA1516: 플랫폼 간 내장 함수 사용

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 참조하세요.