다음을 통해 공유


속성에 식 본문 사용(IDE0025)

재산 가치
규칙 ID IDE0025
타이틀 속성에 식 본문 사용
범주 스타일
하위 범주 언어 규칙(식 본문 멤버)
적용 가능한 언어 C#
옵션 csharp_style_expression_bodied_properties

개요

이 스타일 규칙은 속성에 대한 블록 본문과 식 본문을 사용하는 것과 관련이 있습니다.

옵션

이 규칙의 연결된 옵션 값을 설정하여 속성에 대한 식 본문 또는 블록 본문이 선호되는지 여부와 식 본문이 선호되는 경우 한 줄 식에만 사용하는지 여부를 지정합니다.

옵션 구성에 대한 자세한 내용은 옵션 형식을 참조하세요.

csharp_style_expression_bodied_properties

재산 가치 묘사
옵션 이름 csharp_style_expression_bodied_properties
옵션 값 true 속성에 식 본문을 사용하는 것을 선호합니다.
when_on_single_line 속성이 한 줄인 경우 식 본문을 사용하는 것이 좋습니다.
false 속성에는 블록 구조 사용을 선호하십시오.
기본 옵션 값 true
// csharp_style_expression_bodied_properties = true
public int Age => _age;

// csharp_style_expression_bodied_properties = false
public int Age { get { return _age; }}

이 규칙과 IDE0027

이 규칙 IDE0025IDE0027(접근자에 식 본문 사용)는 매우 유사합니다. IDE0025는 속성 전체에 대한 것이고, IDE0027은 특히나 속성의 접근자 부분에 대한 것입니다.

계산을 수행하지 않고 값을 반환하는 읽기 전용 속성의 경우 IDE0025csharp_style_expression_bodied_properties = false 설정되었지만 IDE0027csharp_style_expression_bodied_accessors = true설정되면 다음과 같은 속성이 표시됩니다.

public int TemperatureF
{
    get => _temp;
}

하지만 IDE0025csharp_style_expression_bodied_properties = true로 설정할 경우, 심지어 IDE0027csharp_style_expression_bodied_accessors = false로 설정하더라도 속성이 더욱 간소화됩니다.

public int TemperatureF => _temp;

읽기-쓰기 속성의 경우 속성이 식 본문 방식으로 작성될 수 없기 때문에(둘 이상의 줄로 구성되기 때문에) 차이가 좀 더 명확하게 나타납니다. 따라서 IDE0025이(가) csharp_style_expression_bodied_properties = true로 설정되어 있어도 여전히 중괄호, 즉 블록 본문으로 결과가 나옵니다.

다음 예제에서는 두 옵션의 다양한 조합으로 속성의 모양을 보여 줍니다.

// csharp_style_expression_bodied_properties = false
// csharp_style_expression_bodied_accessors = true
public int TemperatureB
{
    get => _temp;
}

// csharp_style_expression_bodied_properties = true
// csharp_style_expression_bodied_accessors = true (or false)
public int TemperatureC => _temp;

// csharp_style_expression_bodied_properties = true (or false)
// csharp_style_expression_bodied_accessors = true
public int TemperatureD
{
    get => _temp;
    set => _temp = value;
}

// csharp_style_expression_bodied_properties = true
// csharp_style_expression_bodied_accessors = false
public int TemperatureE
{
    get
    {
        return _temp;
    }
    set
    {
        _temp = value;
    }
}

경고 표시 안 함

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

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

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

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

모든 코드 스타일 규칙을 비활성화하려면 구성 파일에서 범주 Style의 심각도를 none로 설정합니다.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

참고하세요