도구
로그인
한국어

코드 배우기C#

C# 캡슐화

C# 12 기준required · C# 11 부터init · C# 9 부터

C# 속성의 private set·init·required 와 계산 속성을 은행 계좌 예제로 봐요.

한 줄 뜻

객체 안의 값은 숨겨 두고, 바꾸는 길은 검사를 거치는 속성과 메서드 몇 개로만 열어 두는 방법이에요. C# 에서는 속성(property)의 get·set 에 서로 다른 접근 범위를 줘서 이걸 짧게 적어요.

왜 필요한가

아래처럼 Balance 가 public 필드면 잔액이 -20만 원이 돼도 막을 곳이 없어요. 프로그램이 커지면 잔액을 고치는 줄이 수십 군데로 흩어져, 버그가 나도 어디서 망가졌는지 찾기 힘들어요.

Balance 를 { get; private set; } 으로 바꾸면 읽기는 전처럼 되고 바꾸기는 클래스 안으로 모여요. 검사 규칙을 고칠 때도 Deposit·Withdraw 두 곳만 보면 돼요.

일상 비유

우체국 사서함을 떠올려 보세요. 누구나 유리창으로 안에 편지가 있는지 볼 수 있지만(get), 열쇠는 주인만 가져요(private set). 주인을 정하는 일은 사서함을 처음 빌릴 때 한 번뿐이에요(init).

필드를 public 으로 열어 두면 생기는 버그

var acc = new Account();acc.Owner = "Jisoo";acc.Balance = 300_000m;acc.Balance -= 500_000m;acc.Nickname = "";Console.WriteLine($"[{acc.Nickname}] {acc.Owner}: {acc.Balance:N0} won"); class Account{    public string Owner = "";    public string Nickname = "main";    public decimal Balance;}

실행하면

[] Jisoo: -200,000 won

잔액과 별칭이 public 필드라서 누구든 고쳐요. 30만 원 있는 계좌에서 50만 원을 빼도 막는 곳이 없어 -20만 원이 됐어요.

별칭도 빈 글자가 막히지 않고 들어갔어요. 이런 줄이 프로그램 여기저기 있으면 잔액을 망가뜨린 줄을 찾기 어려워요.

예제 코드

Program.cs · 50줄
var acc = new Account { Owner = "Jisoo" };acc.Nickname = "  travel fund  ";acc.Deposit(300_000m);bool ok = acc.Withdraw(500_000m);acc.Withdraw(120_000m);Console.WriteLine($"{acc.Nickname} ({acc.Owner}): {acc.Balance:N0} won");Console.WriteLine($"Refused: {acc.Refused}, low balance: {acc.IsLow}"); class Account{    private string nickname = "main";     public required string Owner { get; init; }    public decimal Balance { get; private set; }    public int Refused { get; private set; }    public bool IsLow => Balance < 200_000m;     public string Nickname    {        get => nickname;        set        {            if (string.IsNullOrWhiteSpace(value))            {                throw new ArgumentException("Nickname cannot be empty");            }            nickname = value.Trim();        }    }     public void Deposit(decimal amount)    {        if (amount <= 0)        {            throw new ArgumentOutOfRangeException(nameof(amount));        }        Balance += amount;    }     public bool Withdraw(decimal amount)    {        if (amount > Balance)        {            Refused++;            return false;        }        Balance -= amount;        return true;    }}

언제 사용하나

  • 틀린 값이 들어가면 안 되는 값(잔액, 재고, 나이, 별칭 길이)
  • 값이 바뀔 때 같이 할 일이 있을 때(거절 횟수 늘리기, 기록 남기기)
  • 처음 한 번만 정하고 다시는 안 바뀌어야 하는 값(주인, 가입일). init 과 required 를 사용해요.

get 만 있고 계산하는 속성(IsLow => Balance < 200_000m)은 따로 값을 고쳐 넣을 필요가 없어 늘 맞는 값을 줘요.

돈은 double 대신 decimal 로 다뤄요. 0.1 같은 값을 정확히 담아요. 숫자 뒤 m 이 decimal 이라는 표시예요.

자주 하는 실수

자동 속성에 set 을 열어 둠

{ get; set; } 은 줄이 짧을 뿐 public 필드와 다를 게 없어요. 아무나 -999 를 넣어요. set 을 private 으로 닫고, 바꾸는 까닭이 드러나는 메서드에서 검사해요.

틀린 코드

var acc = new Wallet();acc.Balance = -999m;Console.WriteLine(acc.Balance); class Wallet{    public decimal Balance { get; set; }}

실행하면-999

고친 코드

var acc = new Wallet();acc.Deposit(-999m);Console.WriteLine(acc.Balance); class Wallet{    public decimal Balance { get; private set; }     public void Deposit(decimal amount)    {        if (amount > 0)        {            Balance += amount;        }    }}

실행하면0

init 속성을 나중에 바꾸려 함

init 은 객체를 만드는 그 자리에서만 값을 받아요. 주인이 바뀌어야 한다면 그건 새 계좌예요. 새 객체를 만들거나, 바뀌어야 하는 값이면 init 대신 검사하는 메서드를 둬요.

틀린 코드

var acc = new Account { Owner = "Jisoo" };acc.Owner = "Somebody";

C# 컴파일러가 내는 오류error CS8852: Init-only property or indexer 'Account.Owner' can only be assigned in an object initializer, or on 'this' or 'base' in an instance constructor or an 'init' accessor.

고친 코드

var acc = new Account { Owner = "Jisoo" };var copy = new Account { Owner = "Somebody" };Console.WriteLine($"{acc.Owner} {copy.Owner}");

실행하면Jisoo Somebody

속성 안에서 자기 자신을 부름

set 안의 Name = ... 은 다시 set 을 불러서 끝없이 돌다 Stack overflow 로 프로그램이 죽어요. 값을 담을 private 필드(소문자 name)를 따로 두고 그 필드를 읽고 써요.

틀린 코드

var tag = new Tag();tag.Name = "sale"; class Tag{    public string Name    {        get => Name;        set => Name = value.Trim();    }}

실행하면Stack overflow.

고친 코드

var tag = new Tag();tag.Name = " sale ";Console.WriteLine(tag.Name); class Tag{    private string name = "";     public string Name    {        get => name;        set => name = value.Trim();    }}

실행하면sale

확인 문제

문제 1

5만 원 든 계좌에서 Withdraw(80_000m) 을 부르면 무엇이 찍힐까요?

var a = new Account { Owner = "Jun" };a.Deposit(50_000m);Console.WriteLine($"{a.Withdraw(80_000m)} {a.Balance}");

답과 까닭 보기

답: 2. False 50000 꺼낼 금액이 잔액보다 크면 거절 횟수만 늘리고 false 를 돌려줘요. 잔액은 그대로 50000 이에요.

문제 2

클래스 밖에서 a.Balance = 0m; 이라고 쓰면 어떻게 될까요?

답과 까닭 보기

답: 2. 컴파일 오류가 나요 Balance 의 set 은 private 이라 Account 밖에서는 값을 넣을 수 없어요. 컴파일러가 CS0272 오류로 막아요.

자주 묻는 것

필드와 속성은 무엇이 다른가요?

필드는 값을 담는 칸이고, 속성은 그 칸을 읽고 쓰는 get·set 메서드를 필드처럼 사용하는 문법이에요. 밖에 보이는 값은 속성으로 열고 필드는 private 으로 둬요.

private set 과 init 은 어떻게 고르나요?

객체가 사는 동안 클래스 안에서 바뀌어야 하면 private set, 만들 때 한 번만 정하고 다시는 안 바뀌어야 하면 init 이에요. 빠뜨리면 안 되는 값이면 required 를 함께 붙여요.

{ get; set; } 만 붙이면 캡슐화인가요?

아니에요. 아무나 set 할 수 있으면 public 필드와 같아요. set 을 닫거나 set 안에서 값을 검사해야 숨긴 뜻이 생겨요.