C# 접근 제한자 6가지와 file, this: 두 어셈블리로 직접 확인

C# 접근 제한자 6단계와 file(C# 11)을 두 어셈블리로 컴파일해 실제 오류 코드까지 확인했습니다. 기본 접근 수준, protected internal 오해, this의 생성자 체이닝·확장 메서드.

2026년 11월 보강: 2021년 글의 예제를 .NET 10.0.14(C# 14)에서 다시 컴파일했습니다. 고친 점이 셋 있습니다. ① 표의 protected internal 설명이 틀렸습니다("같은 어셈블리에서만 protected"가 아니라 "같은 어셈블리 또는 파생 클래스"). ② 접근 제한자는 5개가 아니라, C# 7.2의 private protected를 더해 6단계이고, C# 11에는 형식 전용 file이 생겼습니다. ③ 원문에 실었던 오류 메시지에는 개인 PC의 사용자 폴더 경로가 들어 있어서 지우고, 새로 컴파일한 출력으로 바꿨습니다.

이 글은 public, private 정도만 알고 protected internal과 private protected의 차이가 헷갈리는 분, 그리고 this가 정확히 어디에 쓰이는지 정리하고 싶은 분을 위한 글입니다. 결론부터 말하면 멤버는 안 쓰면 private, 최상위 클래스는 안 쓰면 internal이고, 넓히는 것은 바깥에서 정말 필요할 때만 합니다. 표만 외우면 헷갈리기 쉬워서, 이번에는 라이브러리 어셈블리와 콘솔 어셈블리 두 개를 만들어 모든 조합을 컴파일러에게 직접 물어봤습니다.

2021년 예제의 오류를 .NET 10에서 다시 보기

원문은 접근 제한자를 안 붙인 필드에 바깥에서 접근하는 예제로 시작합니다.

class A {
    int B;
    int C;
}
// Main 안에서
A a = new A();
a.B = 1;
Program.cs(12,15): error CS0122: '보호 수준 때문에 'A.B'에 액세스할 수 없습니다.
Program.cs(3,13): warning CS0169: 'A.B' 필드가 사용되지 않았습니다.

멤버에 접근 제한자를 쓰지 않으면 private이라 클래스 바깥에서 보이지 않습니다. 원문 설명이 맞습니다. public int B;로 바꾸면 오류가 사라집니다.

MSDN(현 Microsoft Learn)에서 가져왔다던 protected 예제도 그대로 재현됩니다.

class X { protected int x = 123; }
class Y : X {
    static void Main() {
        X xa = new X();
        Y yb = new Y();
        xa.x = 10;   // 오류
        yb.x = 10;   // OK
    }
}
Program.cs(15,16): error CS1540: 'X' 형식의 한정자를 통해 보호된 멤버 'X.x'에 액세스할 수 없습니다. 한정자는 'Y' 형식이거나 여기에서 파생된 형식이어야 합니다.

여기서 놓치기 쉬운 점은, Y는 X를 상속했는데도 xa.x는 안 된다는 것입니다. protected는 "파생 클래스가 자기 자신(또는 자기 파생 형식)을 통해서 물려받은 멤버에 접근"하는 것만 허용합니다. 남의 X 객체 속까지 들여다보는 것은 막습니다.

접근 수준 6단계와 file: 두 어셈블리로 컴파일해 본 결과

라이브러리 프로젝트(AccLib)에 멤버 6개를 가진 Base를 만들고, 같은 어셈블리 안의 파생/비파생 클래스, 그리고 이 라이브러리를 참조하는 콘솔 프로젝트의 파생/비파생 코드에서 각각 접근해 봤습니다.

namespace AccLib;
public class Base
{
    public int Pub = 1;
    protected internal int ProtInt = 2;
    internal int Int = 3;
    protected int Prot = 4;
    private protected int PrivProt = 5;
    private int Priv = 6;
    int NoModifier = 7;   // 기본값: private
}

결과를 표로 정리했습니다. ✓는 컴파일 성공, 나머지 칸은 실제로 나온 오류 코드입니다.

접근 제한자 같은 클래스 같은 어셈블리·파생 같은 어셈블리·비파생 다른 어셈블리·파생 다른 어셈블리·비파생
public ✓ ✓ ✓ ✓ ✓
protected internal ✓ ✓ ✓ ✓ CS0122
internal ✓ ✓ ✓ CS0103 CS1061
protected ✓ ✓ CS0122 ✓ CS0122
private protected (C# 7.2) ✓ ✓ CS0122 CS0103 CS1061
private ✓ CS0122 CS0122 CS0103 CS1061

2021년 표에서 바로잡을 곳은 protected internal입니다. 원문은 "같은 어셈블리에서만 protected로 접근 가능"이라고 했지만, 표의 네 번째 열처럼 다른 어셈블리의 파생 클래스에서도 접근됩니다. 이름 그대로 protected 또는 internal입니다. "같은 어셈블리의 파생 클래스만"이라는 AND 조건은 private protected가 맡습니다.

다른 어셈블리에서 internal·private protected·private 멤버에 접근할 때 CS0122(보호 수준)가 아니라 CS0103/CS1061("이름이 없다")이 나온다는 것도 흥미로운 점입니다. 다른 어셈블리에서는 이런 멤버가 아예 보이지 않는 것으로 처리됩니다. 오류 메시지만 보고 "오타인가?" 하고 헤매기 쉬운 지점입니다.

Program.cs(16,13): error CS0103: 'Int' 이름이 현재 컨텍스트에 없습니다.
Program.cs(5,7): error CS0122: '보호 수준 때문에 'Base.ProtInt'에 액세스할 수 없습니다.

단위 테스트 프로젝트가 internal 멤버를 봐야 한다면 멤버를 넓히지 말고 라이브러리에 [assembly: InternalsVisibleTo("테스트프로젝트")]를 붙입니다. 콘솔 프로젝트 이름을 넣자 b.Int를 읽을 수 있게 되는 것을 확인했습니다.

file 형식 (C# 11)

file은 멤버가 아니라 형식에 붙이는 한정자로, 그 소스 파일 안에서만 형식을 쓸 수 있게 합니다. 소스 생성기가 만든 도우미 클래스끼리 이름이 겹치지 않게 하려고 생겼습니다.

// Helper.cs
file static class Helper { public static int Twice(int x) => x * 2; }
static class UsesHelper { public static int Run() => Helper.Twice(21); }   // 같은 파일: OK → 42

다른 파일에서 Helper.Twice(21)을 부르면 error CS0103('Helper' 이름이 현재 컨텍스트에 없습니다)입니다. 멤버에 file int z;처럼 붙이면 error CS0106(이 항목의 'file' 한정자가 유효하지 않습니다), public 메서드의 반환 형식으로 쓰면 error CS9051이 납니다.

버전도 확인했습니다. LangVersion 7.1에서 private protected는 CS8302(… 7.2 or greater), LangVersion 10에서 file class는 CS8936(… 'file types' … 11.0 or greater)이었습니다.

가운데에 누가 접근해야 하는가라는 질문이 있고 주위에 답 7개가 있는 도식. private는 이 클래스만, file은 이 소스 파일만(형식 전용), private protected는 같은 어셈블리의 파생 클래스, protected는 어느 어셈블리든 파생 클래스, internal은 같은 어셈블리의 코드, protected internal은 같은 어셈블리이거나 어디든 파생 클래스, public은 누구나.
C# 접근 제한자 7가지를 좁은 순서대로. 먼저 private로 두고, 바깥에서 정말 필요할 때만 넓힌다. file은 형식에만 붙일 수 있다.

아무것도 안 쓰면: 기본 접근 수준

리플렉션으로 기본값을 확인했습니다.

class Top           : internal
Top.field           : private
Top.Method()        : private
Top.Nested          : private
Top() ctor          : public
IShape.Area()       : public
struct S.field      : private
abstract Abs() ctor : protected
  • 네임스페이스 바로 아래 형식: internal
  • 클래스·구조체의 멤버와 중첩 형식: private
  • 인터페이스 멤버: public
  • 컴파일러가 자동으로 만든 기본 생성자: 보통 public, abstract 클래스면 protected

이 기본값 때문에 자주 만나는 오류가 CS0050입니다. 접근 제한자를 안 붙인 클래스(internal)를 public 메서드가 반환하면 바깥 어셈블리는 반환 형식을 볼 수 없으니 컴파일러가 막습니다.

error CS0050: Inconsistent accessibility: return type 'Hidden' is less accessible than method 'Api.Get()'

this: 자기 자신을 가리키는 세 가지 쓰임

1. 필드와 매개변수 이름이 같을 때

원문의 num = num 예제를 다시 실행했습니다. 2021년에는 출력만 실었지만, 지금 컴파일러는 실수를 미리 알려 줍니다.

class A {
    private int num;
    public A(int num) { num = num; }
    public void Show() => Console.WriteLine("num: " + num);
}
warning CS0649: 'A.num' 필드에는 할당되지 않으므로 항상 0 기본값을 사용합니다.
warning CS1717: 같은 변수에 할당했습니다. 다른 요소를 할당하시겠습니까?
num: 0

this.num = num;으로 바꾸면 num: 50이 나옵니다. this.num은 "이 객체의 필드 num"이고, 그냥 num은 가장 가까운 범위의 매개변수입니다. 경고 두 개를 꺼 두지 않았다면 이 버그는 빌드 단계에서 잡힙니다.

2. 생성자 체이닝 : this(...)

같은 클래스의 다른 생성자를 먼저 호출해서 초기화 코드를 한곳에 모읍니다.

class Point {
    public int X { get; } public int Y { get; }
    public Point() : this(0, 0) { Console.WriteLine("Point()"); }
    public Point(int xy) : this(xy, xy) { Console.WriteLine("Point(int)"); }
    public Point(int x, int y) { X = x; Y = y; Console.WriteLine($"Point(int, int) {x},{y}"); }
}
Point(int, int) 0,0
Point()
Point(int, int) 3,3
Point(int)

: this(...)로 지정한 생성자 본문이 먼저 실행되고 나서 자기 본문이 실행됩니다. 상속까지 포함한 전체 순서와 정적 생성자는 생성자와 소멸자에서 실측 출력으로 다룹니다.

3. 확장 메서드의 this 매개변수와 C# 14 확장 블록

정적 클래스의 정적 메서드 첫 매개변수에 this를 붙이면 그 형식의 인스턴스 메서드처럼 부를 수 있습니다. C# 14(.NET 10)에서는 extension 블록으로 확장 속성까지 만들 수 있게 됐습니다.

static class StringExt {
    public static int WordCount(this string s) =>
        s.Split(' ', StringSplitOptions.RemoveEmptyEntries).Length;
    extension(string s) {
        public bool IsBlank => string.IsNullOrWhiteSpace(s);   // C# 14 확장 속성
    }
}
// "hello world".WordCount() → 2, "hello world".IsBlank → False

extension 블록은 LangVersion 13으로 낮추면 기능 안내 메시지조차 없이 구문 오류(CS1022, CS1513)가 납니다. C# 14 전용 문법입니다.

그 밖에 this는 인덱서 선언(public string this[int i] { get; set; })과, 자기 자신을 다른 객체에 넘길 때(new Node(childName) { Parent = this })도 씁니다. 둘 다 이번에 컴파일해 동작을 확인했습니다.

정리: 실무에서 쓰는 기준

상황 접근 제한자
기본 private (멤버), 형식은 internal부터
라이브러리 밖에 공개하는 API public
같은 프로젝트 안에서만 쓰는 도우미 internal
파생 클래스가 재정의·사용하라고 열어 둔 멤버 protected
내 어셈블리 안의 파생 클래스에게만 private protected
단위 테스트 프로젝트에도 보여야 하는 internal internal + InternalsVisibleTo (protected internal로 넓히지 말 것)
한 파일 안에서만 쓰는 형식 file class

클래스 자체의 기본(필드·속성·required)은 클래스에, 상속은 별도 강좌에서 다룹니다.

테스트 환경: .NET SDK 10.0.403 / 런타임 10.0.14, C# 14(net10.0 기본값), Apple Silicon Mac의 macOS.

자주 묻는 질문

protected internal은 '같은 어셈블리 안에서만 protected'인가요?

아닙니다. protected internal은 '같은 어셈블리이거나(OR) 파생 클래스'입니다. 다른 어셈블리의 파생 클래스에서도 접근됩니다. '같은 어셈블리의 파생 클래스만(AND)'은 C# 7.2에 추가된 private protected입니다. 두 어셈블리로 직접 컴파일해 확인했습니다.

접근 제한자를 안 쓰면 기본값은 무엇인가요?

클래스·구조체의 멤버와 중첩 형식은 private, 네임스페이스 바로 아래의 최상위 클래스는 internal, 인터페이스 멤버는 public입니다. 그래서 public 메서드가 접근 제한자를 안 붙인 클래스를 반환하면 error CS0050(일관성 없는 액세스 가능성)이 납니다.

this.num = num 대신 num = num이라고 쓰면 어떻게 되나요?

매개변수에 자기 자신을 다시 넣는 코드가 되어 필드는 바뀌지 않습니다. 지금 컴파일러는 warning CS1717(같은 변수에 할당했습니다)과 CS0649를 띄우고, 실행하면 num: 0이 출력됩니다.

  • #C#
  • #접근 제한자
  • #access modifier
  • #this
  • #private protected

t.laboratory

직접 만들고 운영하는 앱·서버·서비스에서 겪은 문제와, 그 해결에 쓴 코드를 기록하는 기술 블로그입니다.

운영자 소개 · 앱

↑