정적 Public 멤버 함수
static void	Initialize (Assembly rootAssembly)
static void	Initialize (Assembly rootAssembly, DreamineWpfOptions options)
static void	RegisterDefaultServices (DreamineWpfOptions? options=null)
static void	RegisterGlobalAutoWireHandlerOnce ()
static void	RegisterAutoNavigatorHandlerOnce (string defaultRegionName)
static void	RegisterNavigatorFromWindow (Window window, string regionName)

정적 Private 멤버 함수
static void	RegisterDefaultViewModelResolver ()
static void	AttachViewModelIfExists (object sender, RoutedEventArgs e)

정적 Private 속성
static readonly object	SyncRoot = new()
static bool	_globalAutoWireHandlerRegistered
static bool	_autoNavigatorHandlerRegistered

상세한 설명

Dreamine WPF 애플리케이션 초기화를 담당합니다.

DreamineAppBuilder.cs 파일의 22 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ AttachViewModelIfExists()

void Dreamine.MVVM.Wpf.DreamineAppBuilder.AttachViewModelIfExists	(	object	sender,
		RoutedEventArgs	e )

inlinestaticprivate

WPF FrameworkElement의 Loaded 이벤트에서 호출되는 핸들러입니다. View의 DataContext가 비어 있을 경우, ViewModelLocator를 통해 ViewModel을 자동 연결합니다.

매개변수

sender	이벤트가 발생한 View 인스턴스입니다.
e	라우팅 이벤트 인자입니다.

DreamineAppBuilder.cs 파일의 343 번째 라인에서 정의되었습니다.

        {
            if (sender is not FrameworkElement view)
            {
                return;
            }
 
            if (view.DataContext is not null)
            {
                return;
            }
 
            if (view is not Window && view is not UserControl && view is not Page)
            {
                return;
            }
 
            object? viewModel = ViewModelLocator.Resolve(view.GetType());
            if (viewModel is not null)
            {
                view.DataContext = viewModel;
            }
        }

다음에 의해서 참조됨 : RegisterGlobalAutoWireHandlerOnce().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Initialize() [1/2]

void Dreamine.MVVM.Wpf.DreamineAppBuilder.Initialize ( Assembly rootAssembly )

inlinestatic

Dreamine MVVM WPF 런타임을 기본 옵션으로 초기화합니다.

매개변수

rootAssembly View, ViewModel, Model, Event, Manager 등의 자동 등록 및 매핑 대상으로 사용할 루트 어셈블리입니다.

DreamineAppBuilder.cs 파일의 68 번째 라인에서 정의되었습니다.

        {
            Initialize(rootAssembly, DreamineWpfOptions.CreateDefault());
        }

다음을 참조함 : Dreamine.MVVM.Wpf.DreamineWpfOptions.CreateDefault(), Initialize().

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Initialize() [2/2]

void Dreamine.MVVM.Wpf.DreamineAppBuilder.Initialize	(	Assembly	rootAssembly,
		DreamineWpfOptions	options )

inlinestatic

Dreamine MVVM WPF 런타임을 지정한 옵션으로 초기화합니다.

매개변수

rootAssembly	View, ViewModel, Model, Event, Manager 등의 자동 등록 및 매핑 대상으로 사용할 루트 어셈블리입니다.
options	WPF 런타임 초기화 옵션입니다.

DreamineAppBuilder.cs 파일의 97 번째 라인에서 정의되었습니다.

        {
            ArgumentNullException.ThrowIfNull(rootAssembly);
            ArgumentNullException.ThrowIfNull(options);
 
            if (options.RegisterDefaultServices)
            {
                RegisterDefaultServices(options);
            }
 
            RegisterDefaultViewModelResolver();
 
            // ① DI 자동 등록
            DreamineAutoRegistrar.RegisterAll(rootAssembly);
 
            // ② View ↔ ViewModel 자동 매핑
            ViewModelLocator.RegisterAll(rootAssembly);
 
            // ③ 선택적 Loaded 기반 ViewModel 자동 주입
            if (options.EnableGlobalAutoWireOnLoaded)
            {
                RegisterGlobalAutoWireHandlerOnce();
            }
 
            // ④ 선택적 Region 기반 INavigator 자동 등록
            if (options.EnableAutoNavigatorRegistration)
            {
                RegisterAutoNavigatorHandlerOnce(options.DefaultRegionName);
            }
        }

다음을 참조함 : Dreamine.MVVM.Wpf.DreamineWpfOptions.DefaultRegionName, Dreamine.MVVM.Wpf.DreamineWpfOptions.EnableAutoNavigatorRegistration, Dreamine.MVVM.Wpf.DreamineWpfOptions.EnableGlobalAutoWireOnLoaded, RegisterAutoNavigatorHandlerOnce(), RegisterDefaultServices(), Dreamine.MVVM.Wpf.DreamineWpfOptions.RegisterDefaultServices, RegisterDefaultViewModelResolver(), RegisterGlobalAutoWireHandlerOnce().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ RegisterAutoNavigatorHandlerOnce()

void Dreamine.MVVM.Wpf.DreamineAppBuilder.RegisterAutoNavigatorHandlerOnce ( string defaultRegionName )

inlinestatic

Window Loaded 시점에 지정된 RegionName을 찾아 INavigator를 자동 등록하는 핸들러를 한 번만 등록합니다.

매개변수

defaultRegionName 기본 Region 이름입니다.

예외

ArgumentException 입력 인자가 유효하지 않은 경우 발생합니다.

DreamineAppBuilder.cs 파일의 239 번째 라인에서 정의되었습니다.

        {
            if (string.IsNullOrWhiteSpace(defaultRegionName))
            {
                throw new ArgumentException("Default region name must not be empty.", nameof(defaultRegionName));
            }
 
            lock (SyncRoot)
            {
                if (_autoNavigatorHandlerRegistered)
                {
                    return;
                }
 
                EventManager.RegisterClassHandler(
                    typeof(Window),
                    FrameworkElement.LoadedEvent,
                    new RoutedEventHandler((sender, _) =>
                    {
                        if (sender is Window window)
                        {
                            RegisterNavigatorFromWindow(window, defaultRegionName);
                        }
                    }));
 
                _autoNavigatorHandlerRegistered = true;
            }
        }

다음을 참조함 : _autoNavigatorHandlerRegistered, RegisterNavigatorFromWindow(), SyncRoot.

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ RegisterDefaultServices()

void Dreamine.MVVM.Wpf.DreamineAppBuilder.RegisterDefaultServices ( DreamineWpfOptions? options = null )

inlinestatic

Dreamine WPF 기본 서비스를 등록합니다. 이미 등록된 서비스는 덮어쓰지 않습니다.

매개변수

options 동작을 구성하는 설정입니다.

MS.Extensions.DI 혼용 시 주의사항 (Fix 7) Hybrid(Blazor+WPF) 시나리오에서 IServiceCollection.AddDreamineHybridWpf()를 사용하면 Blazor의 IServiceProvider와 Dreamine의 DMContainer가 동시에 활성화됩니다. 이중 등록으로 인한 혼란을 방지하려면:

App.xaml.cs 의 Composition Root에서 DreamineAppBuilder.Initialize()를 먼저 호출하여 DMContainer를 구성한 후, IServiceCollection에 services.AddSingleton<IViewManager>(sp => DMContainer.Resolve<IViewManager>()) 형태로 브리지 등록하십시오.
단일 서비스를 두 컨테이너 모두에 직접 등록하지 마십시오. 어느 한쪽에만 등록하고 다른 쪽은 팩토리 위임으로 연결하는 것이 안전합니다.
장기적으로는 DMContainer.SetContainer(new MsExtensionsAdapter(serviceProvider)) 패턴으로 DMContainer가 MS.Extensions.DI를 백엔드로 사용하도록 통합할 수 있습니다.

DreamineAppBuilder.cs 파일의 166 번째 라인에서 정의되었습니다.

        {
            if (!DMContainer.IsRegistered<IWindowStateService>())
            {
                DMContainer.RegisterSingleton<IWindowStateService, WindowStateService>();
            }
 
            if (!DMContainer.IsRegistered<IViewManager>())
            {
                var vm = options is not null
                    ? new ViewManager(DMContainer.GetResolver(),
                        options.FallbackWindowWidth,
                        options.FallbackWindowHeight)
                    : new ViewManager();
                DMContainer.RegisterSingleton<IViewManager>(vm);
            }
 
            if (!DMContainer.IsRegistered<IDialogService>())
            {
                DMContainer.RegisterSingleton<IDialogService, WpfDialogService>();
            }
        }

다음에 의해서 참조됨 : Initialize().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ RegisterDefaultViewModelResolver()

void Dreamine.MVVM.Wpf.DreamineAppBuilder.RegisterDefaultViewModelResolver ( )

inlinestaticprivate

Register Default View Model Resolver 작업을 수행합니다.

DreamineAppBuilder.cs 파일의 136 번째 라인에서 정의되었습니다.

        {
            ViewModelLocator.RegisterResolver(
                new DreamineContainerViewModelResolver());
        }

다음에 의해서 참조됨 : Initialize().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ RegisterGlobalAutoWireHandlerOnce()

void Dreamine.MVVM.Wpf.DreamineAppBuilder.RegisterGlobalAutoWireHandlerOnce ( )

inlinestatic

WPF FrameworkElement Loaded 이벤트의 전역 ViewModel 자동 주입 핸들러를 한 번만 등록합니다.

DreamineAppBuilder.cs 파일의 197 번째 라인에서 정의되었습니다.

        {
            lock (SyncRoot)
            {
                if (_globalAutoWireHandlerRegistered)
                {
                    return;
                }
 
                EventManager.RegisterClassHandler(
                    typeof(FrameworkElement),
                    FrameworkElement.LoadedEvent,
                    new RoutedEventHandler(AttachViewModelIfExists));
 
                _globalAutoWireHandlerRegistered = true;
            }
        }

다음을 참조함 : _globalAutoWireHandlerRegistered, AttachViewModelIfExists(), SyncRoot.

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ RegisterNavigatorFromWindow()

void Dreamine.MVVM.Wpf.DreamineAppBuilder.RegisterNavigatorFromWindow	(	Window	window,
		string	regionName )

inlinestatic

지정한 Window 내부에서 RegionName이 일치하는 ContentControl을 찾아 INavigator를 등록합니다.

매개변수

window	Region을 찾을 대상 Window입니다.
regionName	Region 이름입니다.

예외

ArgumentException 입력 인자가 유효하지 않은 경우 발생합니다.

DreamineAppBuilder.cs 파일의 300 번째 라인에서 정의되었습니다.

        {
            ArgumentNullException.ThrowIfNull(window);
 
            if (string.IsNullOrWhiteSpace(regionName))
            {
                throw new ArgumentException("Region name must not be empty.", nameof(regionName));
            }
 
            ContentControl? region = RegionBinderHelper.FindRegionControl(window, regionName);
            if (region is null)
            {
                return;
            }
 
            DMContainer.RegisterSingleton<INavigator>(
                new ContentControlNavigator(region));
        }

다음에 의해서 참조됨 : RegisterAutoNavigatorHandlerOnce().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ _autoNavigatorHandlerRegistered

bool Dreamine.MVVM.Wpf.DreamineAppBuilder._autoNavigatorHandlerRegistered

staticprivate

auto Navigator Handler Registered 값을 보관합니다.

DreamineAppBuilder.cs 파일의 50 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RegisterAutoNavigatorHandlerOnce().

◆ _globalAutoWireHandlerRegistered

bool Dreamine.MVVM.Wpf.DreamineAppBuilder._globalAutoWireHandlerRegistered

staticprivate

global Auto Wire Handler Registered 값을 보관합니다.

DreamineAppBuilder.cs 파일의 41 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RegisterGlobalAutoWireHandlerOnce().

◆ SyncRoot

readonly object Dreamine.MVVM.Wpf.DreamineAppBuilder.SyncRoot = new()

staticprivate

Sync Root 값을 보관합니다.

DreamineAppBuilder.cs 파일의 32 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : RegisterAutoNavigatorHandlerOnce(), RegisterGlobalAutoWireHandlerOnce().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

DreamineAppBuilder.cs

정적 Public 멤버 함수

정적 Private 멤버 함수

정적 Private 속성

상세한 설명

멤버 함수 문서화

◆ AttachViewModelIfExists()

◆ Initialize() [1/2]

◆ Initialize() [2/2]

◆ RegisterAutoNavigatorHandlerOnce()

◆ RegisterDefaultServices()

◆ RegisterDefaultViewModelResolver()

◆ RegisterGlobalAutoWireHandlerOnce()

◆ RegisterNavigatorFromWindow()

멤버 데이터 문서화

◆ _autoNavigatorHandlerRegistered

◆ _globalAutoWireHandlerRegistered

◆ SyncRoot