데이터 바인딩 가이드
MewUI의 데이터 바인딩은 Native AOT와 호환되도록 리플렉션 없이 델리게이트 기반으로 설계되었습니다.
1. 핵심 개념
섹션 제목: “1. 핵심 개념”리플렉션 없는 바인딩
섹션 제목: “리플렉션 없는 바인딩”WPF/WinUI는 무엇에 바인딩할지를 문자열로 적고 런타임에 리플렉션으로 찾습니다. MewUI는 같은 것을 코드로 적습니다.
<!-- WPF --><TextBlock Text="{Binding UserName}" /><TextBlock Text="{Binding Customer.City}" /><TextBlock Text="{Binding Orders[0].Title}" /><TextBlock Text="{Binding Total, StringFormat=N0}" />// MewUInew TextBlock().Bind(TextBlock.TextProperty, vm, x => x.UserName);new TextBlock().Bind(TextBlock.TextProperty, vm, x => x.Customer.City);new TextBlock().Bind(TextBlock.TextProperty, vm, x => x.Orders[0].Title);new TextBlock().Bind(TextBlock.TextProperty, vm, x => x.Total, total => $"{total:N0}");중첩 경로도 문자열이 아니라 코드입니다. 점을 따라가는 각 단계를 컴파일러가 검사하고, 변경 알림도 단계마다 붙습니다. 중간 객체가 통째로 교체되면 그 아래가 다시 연결됩니다(4절).
마지막 줄이 보여주듯 WPF의 StringFormat과 Converter는 MewUI에서 하나로 합쳐집니다. 값을 바꾸는 일은 전부 convert 델리게이트가 맡습니다(3.3절).
문자열이 코드가 되면서 따라오는 것:
- Native AOT 호환: 리플렉션이 없으므로 트리밍해도 안전합니다
- 컴파일 타임 검증: 속성명 오타나 타입 불일치가 빌드에서 걸립니다
- IntelliSense와 리팩터링: 자동 완성이 되고 이름을 바꾸면 바인딩도 함께 바뀝니다
바인딩 모드
섹션 제목: “바인딩 모드”public enum BindingMode{ OneWay, // 소스에서 컨트롤로 TwoWay, // 양방향}기본 모드는 대상 속성이 정합니다. 입력 속성(TextBox.TextProperty 등)은 TwoWay, 표시 속성(Label.TextProperty 등)은 OneWay입니다. 명시적으로 mode를 넘기면 그 값이 우선합니다.
TwoWay로 해석됐는데 소스에 쓸 수단이 없을 때의 처리는 API마다 다릅니다. ObservableValue 변환 바인딩은 convertBack이 없으면 OneWay가 됩니다. INPC 소스와 경로 바인딩은 예외를 던집니다. 입력 컨트롤이 조용히 단방향이 되는 것보다 즉시 알려주는 편이 낫기 때문입니다.
2. 소스 종류
섹션 제목: “2. 소스 종류”바인딩 소스는 셋 중 하나입니다. 어느 것이든 아래 3절의 같은 API로 겁니다.
2.1 ObservableValue<T>
섹션 제목: “2.1 ObservableValue<T>”값 하나를 담고 변경을 알리는 컨테이너입니다. 알림 코드를 직접 쓸 필요가 없습니다.
var name = new ObservableValue<string>("기본값");
string current = name.Value;name.Value = "새 값";
name.Changed += () => Console.WriteLine("변경됨");coerce로 값을 제약할 수 있습니다.
var percent = new ObservableValue<double>(50, v => Math.Clamp(v, 0, 100));percent.Value = 150; // 100percent.Value = -10; // 02.2 INotifyPropertyChanged 뷰모델
섹션 제목: “2.2 INotifyPropertyChanged 뷰모델”평범한 속성을 가진 뷰모델도 INotifyPropertyChanged를 구현하면 그대로 소스가 됩니다. 구독은 약한 참조로 걸리므로, 뷰모델이 오래 유지되어도 그 때문에 화면 객체가 메모리에 남지는 않습니다.
sealed class UserViewModel : INotifyPropertyChanged{ private string _name = "";
public event PropertyChangedEventHandler? PropertyChanged;
public string Name { get => _name; set { _name = value; PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Name))); } }}PropertyChanged의 이름이 null이거나 빈 문자열이면 전체 변경으로 보고 해당 값을 다시 읽습니다.
2.3 다른 MewObject의 MewProperty
섹션 제목: “2.3 다른 MewObject의 MewProperty”컨트롤의 속성을 다른 컨트롤에 직접 연결합니다.
new ProgressBar().Bind(RangeBase.ValueProperty, slider, RangeBase.ValueProperty);2.4 무엇을 고를까
섹션 제목: “2.4 무엇을 고를까”ObservableValue<T>는 알림 코드를 대신 써주므로 MewUI 전용 뷰모델에 편합니다. INotifyPropertyChanged는 이미 있는 MVVM 뷰모델이나 다른 프레임워크와 공유하는 모델에 맞습니다. 둘을 한 뷰모델 안에 섞어도 되고, 4절의 한 경로 안에서 섞어도 됩니다.
알림이 없는 평범한 속성은 소스가 될 수 없습니다. 처음 값만 한 번 읽고 이후로는 갱신되지 않습니다.
3. 바인딩 거는 법
섹션 제목: “3. 바인딩 거는 법”3.1 플루언트 단축 메서드
섹션 제목: “3.1 플루언트 단축 메서드”자주 쓰는 속성에는 전용 메서드가 있습니다. ObservableValue<T>를 받습니다.
new TextBox().BindText(name) // 양방향new Label().BindText(name) // 단방향new Label().BindText(count, c => $"개수: {c}") // 변환new CheckBox().BindIsChecked(isChecked)new Slider().BindValue(volume)new Button().BindIsVisible(isVisible).BindIsEnabled(isEnabled)3.2 Bind와 SetBinding
섹션 제목: “3.2 Bind와 SetBinding”모든 MewProperty<T>에 쓸 수 있는 일반 API입니다. Bind는 요소를 돌려주므로 체이닝에 쓰고, SetBinding은 같은 오버로드를 제공하는 하위 API입니다.
// ObservableValueelement.Bind(Control.BackgroundProperty, colorSource);
// INotifyPropertyChanged 뷰모델new Label().Bind(Label.TextProperty, vm, x => x.Name);
// 대상이 TwoWay면 그대로 양방향입니다. 되돌려 쓰는 코드는 getter 식을 보고 만듭니다.new TextBox().Bind(TextBox.TextProperty, vm, x => x.Name);
// 쓰기 방식을 직접 정하고 싶을 때만 setter를 넘깁니다new TextBox().Bind(TextBox.TextProperty, vm, x => x.Name, (owner, value) => owner.Name = value.Trim());
// 소유자를 통해 도달하는 ObservableValue. 이 오버로드는 INotifyPropertyChanged를 요구하지 않습니다.new Label().Bind(Label.TextProperty, settings, x => x.Caption);
// 다른 MewObject의 속성element.Bind(TextBlock.TextProperty, otherElement, Window.TitleProperty);setter는 선택입니다. 넘기지 않으면 getter 식을 보고 값을 되돌려 쓰는 코드를 컴파일 타임에 만듭니다. 정규화나 검증을 거쳐 쓰려면 직접 넘기고, 그때는 그쪽이 우선합니다.
제너레이터가 돌지 않는 빌드(4.1절의 SDK 조건)에서는 이 합성이 없습니다. 그 경우 TwoWay 대상에 setter 없이 걸면 예외가 납니다. setter를 넘기거나 mode: BindingMode.OneWay를 명시하세요.
INPC 소스의 getter는 멤버 하나만 읽어야 합니다. 구독할 속성 이름을 그 식에서 얻기 때문입니다. 이름과 읽는 값이 어긋날 수 없도록 이름을 직접 넘기는 매개변수는 제공하지 않습니다. 멤버를 여러 단계 지나야 하면 4절을 보세요.
3.3 변환
섹션 제목: “3.3 변환”소스 타입과 대상 타입이 다르면 convert를 넘깁니다. TwoWay에는 convertBack도 필요합니다.
// 숫자를 표시 문자열로new Label().Bind(Label.TextProperty, vm, x => x.Temperature, value => $"{value:0.0} C");
// bool 반전. 로딩 중에는 결과 영역을 숨깁니다results.Bind(UIElement.IsVisibleProperty, vm, x => x.IsLoading, loading => !loading);
// 값의 유무를 표시 여부로banner.Bind(UIElement.IsVisibleProperty, vm, x => x.ErrorMessage, message => !string.IsNullOrEmpty(message));
// 양방향에는 convertBack이 필요합니다textBox.Bind(TextBase.TextProperty, intSource, convert: i => i.ToString(), convertBack: s => int.TryParse(s, out var v) ? v : 0);ObservableValue가 소스이고 대상이 표시/활성화 상태라면 BindIsVisible(source, convert)와 BindIsEnabled(source, convert) 단축 메서드도 같은 일을 합니다.
WPF에서 BooleanToVisibilityConverter나 그 역변환 클래스를 따로 만들던 자리가 여기서는 람다 한 줄입니다. 변환기 클래스를 정의하고 리소스에 등록하는 단계가 없습니다.
계산은 전부 convert에서 합니다. getter에 계산을 넣으면 무엇을 구독해야 할지 판정할 수 없습니다.
3.4 한데 모아보기
섹션 제목: “3.4 한데 모아보기”class LoginViewModel{ public ObservableValue<string> Username { get; } = new(""); public ObservableValue<bool> RememberMe { get; } = new(false); public ObservableValue<string> ErrorMessage { get; } = new(""); public ObservableValue<bool> IsLoading { get; } = new(false);
public void Login() { if (string.IsNullOrEmpty(Username.Value)) { ErrorMessage.Value = "사용자 이름을 입력하세요"; return; }
IsLoading.Value = true; }}new StackPanel() .Vertical() .Spacing(8) .Children( new TextBox() .Placeholder("사용자 이름") .BindText(vm.Username),
new CheckBox() .Content("로그인 유지") .BindIsChecked(vm.RememberMe),
new Label() .Foreground(Color.FromRgb(200, 60, 60)) .BindText(vm.ErrorMessage),
new Button() .Content("로그인") .OnCanClick(() => !vm.IsLoading.Value) .OnClick(() => vm.Login()))4. 중첩 경로
섹션 제목: “4. 중첩 경로”소스가 한 단계 안쪽에 있으면 경로를 씁니다. 경로는 단계별 세그먼트가 이어진 형태이며, 단계마다 그 단계의 소유자를 구독합니다. 중간 객체가 통째로 교체되면 그 뒤의 단계를 다시 연결합니다.
경로는 소스 종류를 가리지 않습니다. 한 경로 안에 ObservableValue, MewProperty, INPC 속성이 섞여도 됩니다.
4.1 점 표기 한 줄
섹션 제목: “4.1 점 표기 한 줄”권장 형태입니다. 점으로 이어 쓰면 컴파일 타임에 단계별 세그먼트로 분해됩니다.
new Label().Bind(Label.TextProperty, vm, x => x.CurrentUser.Profile.DisplayName);단계마다 멤버의 타입을 보고 관찰 방식을 고릅니다. INotifyPropertyChanged면 PropertyChanged, ObservableValue<T>면 그 알림, MewObject의 {이름}Property면 그 속성, 어느 것도 아니면 비관찰 세그먼트입니다.
받는 문법은 여섯 가지입니다.
| 문법 | 예 |
|---|---|
| 멤버 접근 | x.A.B |
| 널 조건 | x.A?.B |
| 하드 캐스팅 | ((User)x.Current).Name |
as 캐스팅 |
(x.Current as User).Name |
| 널 관용 | x.A!.B |
| 상수 인덱서 | x.Items[0].Name |
계산식, 메서드 호출, 삼항 연산자는 경로가 아니므로 컴파일 에러입니다. 계산은 convert로 분리하세요. 인덱스는 상수여야 합니다. 생성되는 경로가 정적 필드라 호출부의 지역 변수를 담을 수 없기 때문입니다.
이 문법은 .NET 9 이상 SDK로 빌드할 때 동작합니다. Roslyn 4.12 미만에서는 소스 제너레이터를 적재할 수 없어 다단 접근이 컴파일 에러가 되고, 4.2의 명시적 체인을 씁니다. 잃는 것은 문법이지 기능이 아닙니다. 겨냥하는 타깃 프레임워크는 무관하며 빌드에 쓰는 SDK만 영향을 줍니다.
4.2 명시적 체인
섹션 제목: “4.2 명시적 체인”경로를 정적 필드로 두고 여러 요소가 공유하거나, 제너레이터가 없는 빌드를 지원할 때 씁니다. BindingPath는 불변이며 붙기 전까지 루트 인스턴스를 보관하지 않습니다.
static readonly BindingPath<AppViewModel, string> DisplayNamePath = BindingPath .From<AppViewModel>() .ThenNotifying(x => x.CurrentUser!) .ThenNotifying(x => x.DisplayName);
new Label().Bind(Label.TextProperty, vm, DisplayNamePath, fallbackValue: "-");중간 노드가 널 허용이면 !를 붙여 다음 단계 소유자 타입을 비널로 맞춥니다. 이 표기는 런타임 null 검사를 끄지 않습니다.
4.3 세그먼트 종류
섹션 제목: “4.3 세그먼트 종류”| 붙이는 방법 | 소유자 | 변경 관찰 | TwoWay 마지막 단계 |
|---|---|---|---|
Then(getter) |
아무거나 | 안 함 | 불가능 |
Then(selector) |
ObservableValue<T>를 내놓는 소유자 |
함 | 가능 |
Then(property) |
MewObject |
함 | 읽기 전용이 아니면 가능 |
ThenNotifying(getter, setter?) |
INotifyPropertyChanged |
함 | setter를 넘기면 가능 |
ThenIndexed(getter) |
통지하는 컬렉션 또는 인덱서 | 함 | 불가능 |
비관찰 Then(getter)은 처음 연결할 때와 앞 단계가 뒤쪽을 다시 만들 때만 값을 읽습니다. getter 결과만 바뀌는 것은 알림이 없으므로 갱신되지 않습니다. 중간값이 생성 후 바뀌지 않는 경우에는 이것이 옳은 선택입니다.
4.4 null과 fallback
섹션 제목: “4.4 null과 fallback”- 중간 값이 null이면 경로를 값 없음 상태로 보고
fallbackValue를 씁니다. 3.2절의 getter 오버로드도 getter나convert바로 뒤에서 이 값을 받습니다. - 관찰 가능한 중간 값이 다시 non-null이 되면 경로를 자동으로 다시 연결합니다.
- 마지막 세그먼트의 null은 실제 소스 값이며 fallback으로 대체하지 않습니다.
- selector가 null
ObservableValue를 반환하면 잘못된 경로이므로 예외를 던집니다.
소유자가 null이면 그 뒤 단계의 selector를 아예 호출하지 않습니다. C#은 이 런타임 보장을 제네릭 시그니처로 표현할 수 없으므로, 널 허용 중간 매개변수에는 예제처럼 !를 씁니다.
4.5 TwoWay 경로
섹션 제목: “4.5 TwoWay 경로”마지막 세그먼트가 쓰기 가능해야 합니다. 4.3 표의 마지막 열을 보세요. 변환 TwoWay 경로에는 convertBack이 필요하며, 경로 바인딩은 OneWay로 조용히 내려가지 않고 예외를 던집니다.
경로가 값 없음 상태인 동안에는 대상에서 바뀐 값을 담아두지 않습니다. 다시 연결되면 현재 소스 값이 fallback이나 임시 값을 덮어씁니다.
4.6 컬렉션
섹션 제목: “4.6 컬렉션”ObservableCollection<T>는 INotifyPropertyChanged도 구현하므로 컬렉션 자신의 속성이 관찰됩니다.
new Label().Bind(Label.TextProperty, vm, x => x.Items.Count, count => $"{count}개");인덱서도 관찰합니다. 소유자가 INotifyCollectionChanged를 구현하면 컬렉션 변경을, 그렇지 않고 INotifyPropertyChanged만 구현하면 "Item[]" 형태의 인덱서 알림을 구독합니다.
// 0번 원소가 교체되거나 앞에 항목이 끼어들면 갱신됩니다new Label().Bind(Label.TextProperty, vm, x => x.Items[0].Name);
// 명시적 체인BindingPath.From<AppViewModel>() .ThenNotifying(x => x.Items) .ThenIndexed(x => x[0]);점 표기에서는 선언된 정적 타입으로 관찰 여부가 정해집니다. IReadOnlyList<T>로 선언된 속성은 실제 인스턴스가 ObservableCollection<T>여도 관찰 세그먼트가 되지 않습니다. ThenIndexed를 직접 쓰면 실제 인스턴스를 보므로 그 제한이 없습니다.
인덱스가 범위를 벗어나면 경로가 값 없음 상태가 되어 fallbackValue를 씁니다. 인덱서가 마지막 세그먼트면 4.4의 규칙대로 null이 실제 값으로 전달됩니다.
목록 화면 자체는 ItemsSource를 쓰세요. 항목 추가와 삭제는 목록 컨트롤이 직접 관찰합니다. 경로의 인덱서는 “특정 위치의 항목 하나”를 볼 때 쓰는 것입니다.
4.7 진단
섹션 제목: “4.7 진단”| ID | 수준 | 내용 |
|---|---|---|
| MEW1201 | 경고 | 소유자가 INotifyPropertyChanged인데 비관찰 Then을 사용. ThenNotifying으로 바꾸는 코드 수정 제공 |
| MEW1202 | 에러 | ThenNotifying의 getter가 단일 멤버 접근이 아님 |
| MEW1203 | 에러 | 점 표기 다단 접근인데 이 빌드에서 제너레이터가 돌지 않음 |
| MEWG001 | 에러 | 경로로 분해할 수 없는 getter |
5. 여러 소스 결합
섹션 제목: “5. 여러 소스 결합”하나의 표시 값이 소스 둘 이상에 의존하면 경로로 표현할 수 없습니다. 경로는 한 단계에 구독이 하나씩만 붙기 때문입니다. 그래서 Bind는 입력 둘에서 넷까지와 결합 함수도 받으며, 입력 중 하나라도 바뀌면 값을 다시 계산합니다.
입력이 모두 같은 뷰모델의 알림 속성이면 소스 뒤에 getter를 나열하고 결합 함수를 마지막에 넘깁니다.
new TextBlock().Bind(TextBlock.TextProperty, vm, x => x.FirstName, x => x.LastName, (first, last) => $"{first} {last}");입력이 서로 다른 객체나 서로 다른 종류의 소스에서 오면 입력마다 BindingInput.From으로 감쌉니다.
new TextBlock().Bind(TextBlock.TextProperty, BindingInput.From(order, x => x.Customer.Name), BindingInput.From(quantitySlider, RangeBase.ValueProperty), BindingInput.From(unitPrice), (customer, count, price) => $"{customer}: {count * price:0.00}");| 입력 | 소스 |
|---|---|
BindingInput.From(vm, x => x.Name) |
INPC 속성 (2.2절). 점 표기 getter는 4.1절을 따릅니다 |
BindingInput.From(root, path) |
BindingPath (4.2절) |
BindingInput.From(observable) |
ObservableValue<T> (2.1절) |
BindingInput.From(element, RangeBase.ValueProperty) |
다른 요소의 속성 (2.3절) |
- 이 바인딩은 항상 단방향입니다.
TextBox.Text처럼 기본값이 양방향인 대상에서도 마찬가지이며, 사용자가 입력한 값은 입력이 바뀔 때까지만 대상에 남습니다. - 결합 함수는 모든 입력을 읽을 수 있을 때만 호출됩니다. 중간 객체가 null이어서 경로가 끊긴 입력이 있으면 대상에는 속성 타입의 기본값이 표시되고, 결합 함수 바로 앞에
fallbackValue를 넘기면 그 값이 표시됩니다. 입력이 실제로 가진 null은 결합 함수에 값으로 전달됩니다. - 입력을 읽지 못하거나 결합 함수가 예외를 던지면 대상은 마지막 값을 유지하고 바인딩 오류를 보고합니다. 다음 변경 때 다시 시도합니다.
BindingInput.From으로 만든 입력은 여러 바인딩에 쓸 수 있습니다. 바인딩마다 소스를 따로 관찰하며,ClearBinding, 대상 dispose,TemplateContext.Reset이 다른 바인딩과 똑같이 정리합니다.
new TextBlock().Bind(TextBlock.TextProperty, vm, x => x.Customer.Name, x => x.Total, "-", // fallbackValue (name, total) => $"{name}: {total}");뷰모델이 결합 값을 가질 수 있다면 뷰모델이 계산해서 알리는 편(예: FullName 속성)이 여전히 더 단순합니다. 뷰가 하나만 보면 되기 때문입니다.
소스가 하나인 계산에는 이 방법이 필요 없습니다. 3.3의 convert를 쓰세요.
6. 수명과 메모리
섹션 제목: “6. 수명과 메모리”관찰하는 세그먼트는 모두 약한 참조로 구독합니다. 소스가 오래 유지되어도 그 때문에 대상이 메모리에 남지는 않습니다. 반대 방향은 성립하지 않습니다. 대상이 바인딩을 소유하므로 ClearBinding, 대상 dispose, TemplateContext.Reset 중 하나가 일어나기 전까지는 대상이 루트와 경로 객체를 함께 붙잡고 있습니다.
바인딩은 컨트롤이 dispose될 때 자동으로 정리됩니다.
var textBox = new TextBox().BindText(vm.Name); // 창이 닫히면 함께 해제ClearBinding은 바인딩과 그 바인딩이 넣은 값까지 제거하고 다음 하위 소스를 드러냅니다. 값이 남지 않는다는 점에 주의하세요.
ObservableValue를 직접 구독했다면 직접 해제합니다.
counter.Subscribe(OnChanged);counter.Unsubscribe(OnChanged);경로에 넘기는 람다에 static은 필수가 아니라 권장입니다. 경로가 델리게이트를 보관하므로 캡처한 객체는 경로나 그것을 쓰는 바인딩만큼 삽니다.
7. 컨트롤별 메서드
섹션 제목: “7. 컨트롤별 메서드”Label
섹션 제목: “Label”| 메서드 | 방향 | 설명 |
|---|---|---|
BindText(ObservableValue<string>) |
단방향 | 텍스트 |
BindText<T>(ObservableValue<T>, Func<T, string>) |
단방향 | 변환 |
TextBox / MultiLineTextBox
섹션 제목: “TextBox / MultiLineTextBox”| 메서드 | 방향 | 설명 |
|---|---|---|
BindText(ObservableValue<string>) |
양방향 | 텍스트 입력 |
Button
섹션 제목: “Button”| 메서드 | 방향 | 설명 |
|---|---|---|
BindContent(ObservableValue<string>) |
단방향 | 버튼 텍스트 |
BindContent<T>(ObservableValue<T>, Func<T, string>) |
단방향 | 변환 |
CheckBox / RadioButton / ToggleSwitch
섹션 제목: “CheckBox / RadioButton / ToggleSwitch”| 메서드 | 방향 | 설명 |
|---|---|---|
BindIsChecked(ObservableValue<bool>) |
양방향 | 체크 상태 |
ListBox / ComboBox
섹션 제목: “ListBox / ComboBox”| 메서드 | 방향 | 설명 |
|---|---|---|
BindSelectedIndex(ObservableValue<int>) |
양방향 | 선택 인덱스 |
Slider / ProgressBar
섹션 제목: “Slider / ProgressBar”| 메서드 | 방향 | 설명 |
|---|---|---|
BindValue(ObservableValue<double>) |
Slider 양방향, ProgressBar 단방향 | 값 |
UIElement 공통
섹션 제목: “UIElement 공통”| 메서드 | 방향 | 설명 |
|---|---|---|
BindIsVisible(ObservableValue<bool>) |
단방향 | 표시 상태 |
BindIsEnabled(ObservableValue<bool>) |
단방향 | 활성화 상태 |
모든 MewProperty
섹션 제목: “모든 MewProperty”| 메서드 | 방향 | 설명 |
|---|---|---|
Bind(MewProperty<T>, ObservableValue<T>) |
기본 | 직접 |
Bind(MewProperty<TProp>, ObservableValue<TSource>, convert, convertBack?) |
기본 | 변환 |
Bind(MewProperty<T>, TSource, getter, setter?) |
대상 기본값 | INPC 소스 (2.2절). setter는 선택 |
Bind(MewProperty<TProp>, TSource, getter, convert, setter?, convertBack?) |
convertBack 있으면 양방향 | INPC 변환 |
Bind(MewProperty<T>, TSource, Func<TSource, ObservableValue<T>>) |
기본 | 소유자를 통해 도달하는 ObservableValue |
Bind(MewProperty<T>, MewObject, MewProperty<T>) |
기본 | 다른 요소의 속성 (2.3절) |
Bind(MewProperty<T>, TRoot, BindingPath<TRoot, T>, mode?, fallbackValue?) |
기본 | 경로 (4절) |
Bind(MewProperty<T>, TSource, getter, fallbackValue, setter?) |
대상 기본값 | fallback이 있는 INPC 소스 (4.4절) |
Bind(MewProperty<TProp>, TSource, getter, convert, fallbackValue, setter?, convertBack?) |
convertBack 있으면 양방향 | fallback이 있는 INPC 변환 (4.4절) |
Bind(MewProperty<TProp>, TSource, getter1, getter2, fallbackValue?, combine) |
단방향 | 한 소스의 속성 둘에서 넷 (5절) |
Bind(MewProperty<TProp>, BindingInput<T1>, BindingInput<T2>, fallbackValue?, combine) |
단방향 | 입력 둘에서 넷 (5절) |
SetBinding이 같은 조합을 제공하며 Bind는 그 위의 플루언트 래퍼입니다.
8. 모범 사례
섹션 제목: “8. 모범 사례”알림을 내는 소스를 쓰세요
섹션 제목: “알림을 내는 소스를 쓰세요”// 좋음: ObservableValueclass ViewModel { public ObservableValue<string> Name { get; } = new(""); }
// 좋음: INotifyPropertyChangedclass ViewModel : INotifyPropertyChanged { public string Name { get; set; } }
// 나쁨: 알림이 없어 갱신되지 않음class ViewModel { public string Name { get; set; } }표시 로직은 UI 레이어에
섹션 제목: “표시 로직은 UI 레이어에”// 좋음: 바인딩에서 변환new Label().BindText(vm.Price, p => $"${p:N0}");
// 나쁨: 뷰모델에서 포매팅class ViewModel { public ObservableValue<string> FormattedPrice { get; } }유효성은 coerce로
섹션 제목: “유효성은 coerce로”var age = new ObservableValue<int>(0, v => Math.Clamp(v, 0, 150));중첩은 점 표기로, 공유는 명시적 체인으로
섹션 제목: “중첩은 점 표기로, 공유는 명시적 체인으로”// 한 곳에서만 쓰는 경로label.Bind(Label.TextProperty, vm, x => x.CurrentUser.Profile.DisplayName);
// 여러 요소가 공유하는 경로static readonly BindingPath<AppViewModel, string> DisplayName = /* 4.2절 */;