Repository navigation
Threading and Collections
비동기는 백그라운드 실행을 뜻하지 않습니다. 화면 전환과 UI 상태 변경은 UI 스레드에서 호출하고, I/O 대기는 await합니다. 무거운 계산은 필요에 따라 별도 작업으로 분리합니다.
WPF 초기화가 Execute.Dispatcher를 연결합니다. IDispatcher.InvokeAsync는 Action·Func·Func·Func<Task를 받고, 비동기 콜백은 내부 Task의 결과·예외·취소까지 전달합니다.
| API | 동작 |
|---|---|
| IDispatcher.InvokeAsync | WPF 큐에 게시하고 실제 작업 완료를 기다림 |
| Execute.InvokeAsync | 위 동작. UI에서도 항상 게시 |
| Execute.RunAsync | 현재 UI이면 즉시 시작, 아니면 게시. 내부 Task까지 대기 |
| Post / Execute.Post | Action 게시 후 반환. 완료를 기다리지 않음 |
| Execute.Run | 현재 UI이면 Action 즉시 실행, 아니면 게시 |
| Send / Execute.Send | 동기 실행·대기. 현재 UI이면 직접 실행 |
위 API는 모두 우선순위를 지정할 수 있습니다. 같은 UI에서 직접 실행하는 경로에는 큐 우선순위가 적용되지 않습니다.
| DispatchPriority | WPF 대응 |
|---|---|
| Lowest = 0 — 기본값 | Background |
| Low = 1 | Input |
| Middle = 2 | Loaded |
| High = 3 | Render |
| Highest = 4 | Normal |
기본값은 입력·렌더링에 양보하는 Lowest입니다. 우선순위는 대기 중인 작업의 상대적 순서이며 실행 중인 콜백을 끊지는 않습니다. WPF의 Send 우선순위는 매핑하지 않습니다. 동기 실행 메서드 이름인 Send와는 별개입니다.
공통 enum에는 플랫폼 타입을 넣지 않습니다. Avalonia 등 다른 어댑터도 구현할 수 있지만, 같은 단계가 동일한 렌더링 시점을 뜻하지는 않습니다. 현재 UI 어댑터는 WPF만 제공합니다.
Screen 파생 VM의 비동기 메서드 안에서 사용합니다. token은 호출자가 받은 CancellationToken입니다.
await Execute.InvokeAsync(async () =>
{
await Task.Delay(100, token); // 실제 비동기 작업으로 교체
this.DisplayName = "완료";
}, DispatchPriority.Lowest, token);
string title = await Execute.Dispatcher.InvokeAsync(
() => this.DisplayName, DispatchPriority.Low);Gyedo과 System.Threading.Tasks를 추가합니다. async 람다는 Async 메서드에 전달하세요. Action만 받는 Post·Send·Run에 넣으면 async void가 되어 완료를 기다리지 못합니다.
콜백은 UI에서 시작하지만 Task.Run·ConfigureAwait(false)로 이동한 코드까지 자동으로 UI에 되돌리지는 않습니다. 무거운 동기 코드는 우선순위가 낮아도 실행 중 UI를 점유합니다.
- 실행 전 토큰 취소는 콜백을 실행하지 않고 Task를 취소합니다.
- 시작한 작업은 강제 중단하지 않습니다. 내부 비동기 작업에도 토큰을 전달해 취소에 협력하게 합니다.
- 콜백의 예외는 반환 Task에서 관찰합니다. 비동기 콜백이 null Task를 반환하면 오류입니다.
- WPF 종료로 큐의 대기 작업이 중단되면 취소된 Task로 끝납니다. 이미 시작한 작업이 UI를 다시 사용해야 한다면 Dispatcher 종료 전에 완료를 기다립니다.
- 완료가 필요 없는 Post는 종료 중 실행되지 않을 수 있습니다. 완료 확인이 필요한 작업은 InvokeAsync를 사용합니다.
UI에서 .Wait()·.Result로 Task를 막지 않습니다. WPF 연결 전 SynchronousDispatcher는 현재 스레드에서 즉시 실행하며 큐·우선순위 정렬은 없습니다. 테스트·비 UI 환경에서도 내부 Task 완료와 예외·취소는 전달합니다.
VM에서 this.PropertyChangedDispatcher = Execute.Run;로 PropertyChanged·ErrorsChanged 전달을 UI로 보낼 수 있습니다. 기본값은 즉시 동기 실행입니다.
이는 알림만 옮깁니다. 필드 변경, PropertyChanging, 생성 콜백, 명령 상태 알림까지 함께 이동하지는 않습니다. 가능한 한 UI 변경 작업 전체를 UI 스레드에서 실행하세요.
using Gyedo;
var rows = new BindableCollection<string>();
rows.AddRange(new[] { "첫 번째", "두 번째" });
rows.RemoveRange(new[] { "첫 번째" });
rows.Refresh();범위 변경은 Reset 알림을 보내므로 UI가 목록 전체를 갱신할 수 있습니다. 컬렉션 변경에는 Execute의 동기 UI 전달을 사용하지만, 동시에 읽고 쓰는 용도의 컬렉션은 아닙니다.
Conductor.Items는 읽기 전용 화면 목록입니다. 이 예제의 데이터 컬렉션과 달리 AddItemAsync·ActivateItemAsync·CloseItemAsync·ClearAsync로 변경합니다. 탐색