다음을 통해 공유

CA1877: 'Path.Combine' 또는 'Path.Join' 오버로드 사용

재산 가치
규칙 아이디 CA1877
Title 사용 Path.Combine 또는 Path.Join 오버로드
범주 성능
수정 사항이 문제를 해결하고 있는지 혹은 새로운 문제를 일으키지 않는지 여부 Non-breaking
.NET 10에서 기본적으로 사용하도록 설정 제안 사항

원인

경로를 빌드하는 데 여러 연속 Path.Combine 또는 Path.Join 작업이 사용됩니다.

규칙 설명

여러 연속 Path.Combine 또는 Path.Join 작업을 사용하는 경우 여러 경로 세그먼트를 허용하는 오버로드를 사용하는 것이 더 효율적입니다. 이 방법은 할당 및 함수 호출 수를 줄여 성능을 향상시킵니다. 두 메서드 모두 여러 매개 변수를 허용하는 오버로드를 제공하므로 연속 작업을 단일 호출로 축소할 수 있습니다.

위반을 해결하는 방법

모든 경로 세그먼트를 허용하는 오버로드를 사용하여 연속 Path.Combine 또는 Path.Join 작업을 단일 호출로 바꿉니다.

이 변환을 자동으로 수행하는 코드 수정 을 사용할 수 있습니다.

Example

다음 코드 조각은 CA1877 위반을 보여줍니다.

public string GetFilePath(string folder, string subfolder, string filename)
{
    // Violation.
    string temp = Path.Combine(folder, subfolder);
    return Path.Combine(temp, filename);
}

public string GetLogPath(string baseDir, string date, string category)
{
    // Violation.
    return Path.Join(Path.Join(baseDir, date), category);
}

Public Function GetFilePath(folder As String, subfolder As String, filename As String) As String
    ' Violation.
    Dim temp As String = Path.Combine(folder, subfolder)
    Return Path.Combine(temp, filename)
End Function

Public Function GetLogPath(baseDir As String, [date] As String, category As String) As String
    ' Violation.
    Return Path.Join(Path.Join(baseDir, [date]), category)
End Function

다음 코드 조각은 위반을 해결합니다.

public string GetFilePath(string folder, string subfolder, string filename)
{
    // No violation.
    return Path.Combine(folder, subfolder, filename);
}

public string GetLogPath(string baseDir, string date, string category)
{
    // No violation.
    return Path.Join(baseDir, date, category);
}

Public Function GetFilePath(folder As String, subfolder As String, filename As String) As String
    ' No violation.
    Return Path.Combine(folder, subfolder, filename)
End Function

Public Function GetLogPath(baseDir As String, [date] As String, category As String) As String
    ' No violation.
    Return Path.Join(baseDir, [date], category)
End Function

경고를 표시하지 않는 경우

성능이 중요하지 않은 경우 이 규칙에서 경고를 표시하지 않는 것이 안전합니다.

경고 표시 안 함

단일 위반을 억제하려면, 소스 파일에 전처리기 지시문을 추가하여 규칙을 비활성화한 다음 다시 활성화하세요.

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

파일, 폴더 또는 프로젝트에 대한 규칙을 비활성화하려면 none에서 해당 심각도를 로 설정하세요.

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

자세한 내용은 코드 분석 경고를 표시하지 않는 방법을 참조하세요.

참고하십시오

  • Last updated on