도구
로그인
한국어

코드 배우기C#

C# 접근 제어자

C# 12 기준private protected · C# 7.2 부터

public·private·protected·internal 과 두 가지 묶음 범위가 어디서 보이는지 표로 봐요.

한 줄 뜻

클래스와 멤버 앞에 붙여 "이것을 어디서 사용할 수 있는가"를 정하는 낱말이에요. C# 은 클래스(같은 클래스·자식)와 어셈블리(같은 프로젝트) 두 기준을 섞어 여섯 가지를 둬요.

왜 필요한가

모든 것을 public 으로 열면 다른 개발자가 체력이나 레벨을 아무 데서나 바꿔요. 나중에 규칙을 고치려 해도 그 값을 사용하는 곳이 너무 많아 손대기 어려워요.

필요한 만큼만 열면, 닫아 둔 쪽은 마음 놓고 고칠 수 있어요. 컴파일러가 범위를 지켜 주니 실수로 건드릴 일도 없어요.

일상 비유

회사 건물 출입증을 떠올려 보세요. 로비는 누구나(public), 사무실 층은 우리 회사 사람만(internal), 연구실은 그 팀과 그 팀에서 갈라져 나온 팀만(protected), 금고는 담당자 한 명만(private) 들어가요. 출입증마다 열리는 문이 달라요.

예제 코드

Program.cs · 64줄
var hero = new Knight("Aria");hero.TakeHit(30);hero.Rest();var rival = new Knight("Bram");rival.TakeHit(50);Console.WriteLine(hero.Status());Console.WriteLine($"Aria stronger: {hero.StrongerThan(rival)}");Console.WriteLine($"Max HP: {GameRules.MaxHp}"); static class GameRules{    public const int MaxHp = 100;    internal static int RestHeal => 10;} public class Character{    private int hp = GameRules.MaxHp;     public string Name { get; }    protected int Armor { get; set; } = 5;    private protected int Level { get; set; } = 1;    protected internal int Gold { get; set; }     public Character(string name)    {        Name = name;    }     public void TakeHit(int damage)    {        hp = Math.Max(0, hp - Math.Max(0, damage - Armor));    }     protected void Heal(int amount)    {        hp = Math.Min(GameRules.MaxHp, hp + amount);    }     public bool StrongerThan(Character other)    {        return hp > other.hp;    }     public string Status()    {        return $"{Name}: hp {hp}, armor {Armor}, level {Level}, gold {Gold}";    }} public class Knight : Character{    public Knight(string name) : base(name)    {        Armor = 12;    }     public void Rest()    {        Heal(GameRules.RestHeal);        Level++;        Gold += 5;    }}

어디서 보이나(어셈블리 = 프로젝트 하나를 빌드한 dll)

접근 제어자같은 클래스같은 어셈블리 자식같은 어셈블리 다른 클래스다른 어셈블리 자식다른 어셈블리 다른 클래스
publicOOOOO
protected internalOOOOX
internalOOOXX
protectedOOXOX
private protectedOOXXX
privateOXXXX

아무것도 사용하지 않으면 클래스 안 멤버는 private, 파일 맨 바깥 형식은 internal 이에요. 자바의 "같은 패키지"는 C# 에 없고, 그 자리를 internal(같은 어셈블리)이 맡아요.

언제 사용하나

  • 처음에는 private 으로 두고, 밖에서 필요할 때만 넓혀요
  • 자식 클래스만 사용해야 하는 도움 메서드는 protected
  • 라이브러리를 만들 때 프로젝트 안에서만 사용하는 도움 형식은 internal 로 둬서 사용하는 사람에게 안 보이게 해요

protected internal 은 둘 중 하나만 맞아도(같은 프로젝트이거나 자식), private protected 는 둘 다 맞아야(같은 프로젝트의 자식) 열려요.

private 은 클래스 단위라 같은 클래스 코드는 다른 객체의 private 도 읽어요(StrongerThan).

자주 하는 실수

아무것도 사용하지 않으면 열려 있다고 생각함

C# 클래스 안 멤버는 아무것도 사용하지 않으면 private 이에요. 밖에서 읽어야 하면 public 을 붙이되, 필드보다는 읽기 전용 속성으로 열어요.

틀린 코드

var box = new Box();Console.WriteLine(box.size); class Box{    int size = 3;}

C# 컴파일러가 내는 오류error CS0122: 'Box.size' is inaccessible due to its protection level

고친 코드

var box = new Box();Console.WriteLine(box.Size); class Box{    public int Size { get; } = 3;}

실행하면3

public 메서드가 internal 형식을 내보냄

Secret 은 아무것도 사용하지 않아서 internal 인데 public 메서드가 돌려주면, 다른 프로젝트는 받은 값의 형식조차 볼 수 없어요. 메서드 범위를 줄이거나 형식을 public 으로 맞춰요.

틀린 코드

public class Vault{    public Secret Open() => new Secret();} class Secret{}

C# 컴파일러가 내는 오류error CS0050: Inconsistent accessibility: return type 'Secret' is less accessible than method 'Vault.Open()'

고친 코드

public class Vault{    internal Secret Open() => new Secret();} class Secret{}

자식 안에서 다른 객체의 protected 를 부모 형식으로 씀

protected 는 "내 자식 형식을 거쳐서"만 열려요. Character 형식 변수로는 남의 Armor 를 못 바꿔요. 자기 형식(Paladin)으로 받거나 부모에 공개 메서드를 둬요.

틀린 코드

class Paladin : Character{    public Paladin(string name) : base(name)    {    }     public void Shield(Character ally)    {        ally.Armor += 5;    }}

C# 컴파일러가 내는 오류error CS1540: Cannot access protected member 'Character.Armor' via a qualifier of type 'Character'; the qualifier must be of type 'Paladin' (or derived from it)

고친 코드

class Paladin : Character{    public Paladin(string name) : base(name)    {    }     public void Shield(Paladin ally)    {        ally.Armor += 5;    }}

확인 문제

문제 1

갑옷 12 인 기사가 10 을 맞으면 무엇이 찍힐까요?

var k = new Knight("Cy");k.TakeHit(10);Console.WriteLine(k.Status());

답과 까닭 보기

답: 3. Cy: hp 100, armor 12, level 1, gold 0 10 - 12 는 음수라 Math.Max(0, ...) 가 0 으로 막아요. 체력은 100 그대로예요.

문제 2

클래스 안 필드 int n; 앞에 아무것도 사용하지 않으면 어떤 범위일까요?

답과 까닭 보기

답: 3. private 클래스 안 멤버의 기본은 private 이에요. 그래서 밖에서 c.n 을 사용하면 CS0122 오류가 나요. 파일 맨 바깥 클래스의 기본(internal)과 헷갈리지 않게 해요.

자주 묻는 것

아무것도 사용하지 않으면 어떤 범위인가요?

클래스 안 멤버는 private, 파일 맨 바깥에 둔 클래스·record·interface 는 internal 이에요. 자바처럼 같은 패키지 범위는 없어요.

internal 은 어디까지 보이나요?

같은 어셈블리, 곧 같은 프로젝트를 빌드한 dll 안에서는 어디서나 보여요. 다른 프로젝트에서는 안 보여서 라이브러리 안쪽 도움 형식에 사용해요.

protected internal 과 private protected 는 어떻게 다른가요?

protected internal 은 같은 프로젝트이거나 자식이면 보이고, private protected 는 같은 프로젝트 안의 자식일 때만 보여요. 앞은 둘 중 하나, 뒤는 둘 다예요.