CA1050: 네임스페이스에 형식을 선언하십시오.

속성	값
규칙 ID	CA1050
타이틀	네임스페이스에 형식을 선언하세요.
범주	디자인
수정 사항이 주요 변경인지 여부	주요 변경
.NET 8에서 기본적으로 사용	제안 사항

원인

public 형식 또는 protected 형식은 명명된 네임스페이스의 범위 밖에서 정의됩니다.

규칙 설명

이름 충돌을 방지하고 관련된 형식을 개체 계층 구조로 구성하기 위해 형식은 네임스페이스 안에 선언됩니다. 명명된 네임스페이스 외부에 있는 형식은 코드에서 참조할 수 없는 전역 네임스페이스에 있습니다.

위반 문제를 해결하는 방법

해당 규칙 위반 문제를 해결하려면 형식을 네임스페이스에 저장합니다.

경고를 표시하지 않는 경우

해당 규칙에서 경고를 표시하지 않아도 되지만 어셈블리를 다른 어셈블리와 함께 사용하지 않을 때는 해당 작업을 수행하는 것이 안전합니다.

경고 표시 안 함

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

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

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

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

자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.

예 1

다음 예제에서는 네임스페이스 외부에서 잘못 선언된 형식 및 네임스페이스에 선언된 동일한 이름의 형식을 가진 라이브러리를 보여 줍니다.

// Violates rule: DeclareTypesInNamespaces.
using System;

public class Test
{
    public override string ToString()
    {
        return "Test does not live in a namespace!";
    }
}

namespace ca1050
{
    public class Test
    {
        public override string ToString()
        {
            return "Test lives in a namespace!";
        }
    }
}

' Violates rule: DeclareTypesInNamespaces.
Public Class Test     

    Public Overrides Function ToString() As String        
        Return "Test does not live in a namespace!"    
    End Function 
    
End Class

Namespace ca1050

    Public Class Test

        Public Overrides Function ToString() As String
            Return "Test lives in a namespace!"
        End Function

    End Class

End Namespace

예제 2

다음 적용 예제는 이전에 정의된 라이브러리를 사용합니다. 이름인 Test가 네임스페이스에 의해 정규화되지 않을 때 네임스페이스 외부에 선언된 형식이 만들어집니다. 네임스페이스 내에 선언된 Test 형식에 액세스하려면 네임스페이스 이름이 필요합니다.

public class MainHolder
{
    public static void Main1050()
    {
        Test t1 = new Test();
        Console.WriteLine(t1.ToString());

        ca1050.Test t2 = new ca1050.Test();
        Console.WriteLine(t2.ToString());
    }
}

Public Class MainHolder

    Public Shared Sub Main1050()
        Dim t1 As New Test()
        Console.WriteLine(t1.ToString())

        Dim t2 As New ca1050.Test()
        Console.WriteLine(t2.ToString())
    End Sub

End Class