2.1 개요

📚 Microsoft Docs: Microsoft CommunityToolkit MVVM - ObservableProperty

*우측 목차를 학습 기준으로 합니다.

✔️ [ObservableProperty] 의미

Observable = "감지 가능한"으로 해석하면, 좀 더 이해하기 쉽습니다.
Observable + Property = "(변경 상태) 감지 가능한 + 프로퍼티"

프로퍼티에 값이 할당되는 것과 같은

변경 사항을 감지(또는 추적, 관찰) 가능한 프로퍼티를 의미합니다.

✔️ 사용목적

C# MVVM 구조에서, [ObservableProperty] 어트리뷰트의 사용 목적은,

프로퍼티의 변경 사항을 감지하여, 다음 동작을 진행하도록 합니다.

➡️ ObservableProperty는 프로퍼티 값 변화 → 이벤트 트리거 → 연결 동작 실행 의 패턴을 통해

프로퍼티 값이 바뀌면 연결된 어떤 로직이 자동으로 실행되게 해주는 기능 입니다.

예를 들면 프로퍼티 값이 바뀌면

UI에 반영되기도 하고, DB에 저장되기도 하고, 서버로 전송되기도 하고, 스타일이 바뀌거나 알림창이 뜹니다.

✔️ 예시

✔️ 사전 지식

❶OOP의 등장 배경을 기반으로 ❷접근 제어자의 사용 이유와, ❸필드와 캡슐화 그리고 ❹프로퍼티 이론이 학습되었다고 가정하고 진행합니다. 

✔️ [ObservableProperty] 어트리뷰트 사용법

[ObservableProperty]
private string name;

C#에서는 객체 내부의 값을 저장하기 위해 필드(field)를 사용합니다.
그리고 캡슐화된 필드를 외부 객체가 접근할 수 있도록 프로퍼티(property)를 제공합니다.

MVVM 패턴의 C# 애플리케이션에서는

View와 ViewModel 간의 느슨한 결합(loose coupling)을 유지하면서도  프로퍼티의 변경 사항을 UI에 알리기 위해,

개발자가 반복적이고 복잡한 소스코드(예: INotifyPropertyChanged 구현)를 직접 작성해야 했습니다.

이러한 반복 작업을 간소화하고 생산성과 유지보수성을 향상시키기 위해,
CommunityToolkit.Mvvm 패키지에서는 Source Generator 기반의 기능을 제공합니다.

사용 방법은 매우 간단합니다.
필드 위에 [ObservableProperty] 어트리뷰트를 붙이기만 하면,
빌드 시점에 View에서 바인딩 가능한 프로퍼티와 PropertyChanged 이벤트 호출 코드가 자동으로 생성됩니다.

이를 통해 개발자는 코드 자동완성(intellisense)과 함께 더욱 간편하고 효율적으로 MVVM 프로퍼티를 구현할 수 있습니다.

1. [ObservableProperty] 어트리뷰트를 사용하면, Source Generator가 다음과 같은 코드를 자동으로 생성합니다

• 필드 → 프로퍼티 선언
• PropertyChanged 이벤트 발생 코드

즉, [ObservableProperty] 한 줄만으로도 ViewModel에 바인딩 가능한 속성을 매우 간단하게 구현할 수 있습니다.

2. 하지만, MVVM Toolkit의 자동 생성 코드만으로는 모든 프로젝트 요구사항을 구현할 수 없기 때문에,

기본적인 C# 코드로 INotifyPropertyChanged를 수동으로 구현하는 방법을 배우고,

내부 동작 원리를 이해하는 것이 매우 중요합니다.

이러한 기초 지식을 통해,

자동 생성 기능의 동작 방식과 한계를 정확히 이해하고,

각 상황에 맞는 적절한 선택을 할 수 있게 됩니다.