Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader 클래스 참조

더 자세히 ...

클래스
class	LoadedViewInfo
class	EmbeddedHostControl

정적 Public 멤버 함수
static LoadedViewInfo	LoadViewWithViewModel (string typeName, bool useSingletonView)

정적 Private 멤버 함수
static string	StripViewSuffix (string name)
static ? Type	ResolveViewModelType_Strict (string actualTypeName, Type? viewType)
static FrameworkElement	ResolveFrameworkElement (Type? viewType, string typeName, bool resetDataContext)
static void	ApplyDataContext (FrameworkElement root, object vm)
static void	MergeResources (ResourceDictionary target, ResourceDictionary source)
static Type[]	GetTypesSafe (this Assembly asm)
static IEnumerable< T >	SelectManySafe< T > (this IEnumerable< Assembly > assemblies, Func< Assembly, IEnumerable< T > > selector)

상세한 설명

이름 규칙과 DI를 이용해 뷰 및 뷰 모델을 만들고 임베드 가능한 요소로 연결합니다.

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

멤버 함수 문서화

ApplyDataContext()

void Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.ApplyDataContext ( FrameworkElement root, object vm )

inlinestaticprivate

루트와 실제 호스트 콘텐츠에 뷰 모델을 데이터 컨텍스트로 적용합니다.

매개변수

root	데이터 컨텍스트를 받을 루트 요소입니다.
vm	적용할 뷰 모델 인스턴스입니다.

프레임 콘텐츠가 아직 없으면 다음 탐색 또는 로드 시 한 번 적용하며, null 입력은 무시합니다.

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

        {
            if (root == null || vm == null)
            {
                return;
            }
 
            // --- Frame 전용 처리: Page 로드 타이밍 보장 ---
            if (root is Frame fr)
            {
                // Frame 자신에도 ViewModel 설정
                fr.DataContext = vm;
 
                // 로컬: 실제 컨텐츠에 주입
#pragma warning disable CS1587 // Doxygen documents local functions; the C# compiler does not attach XML docs to them.
                void TrySet(FrameworkElement fe)
                {
                    if (fe != null)
                    {
                        fe.DataContext = vm;
                    }
                }
#pragma warning restore CS1587
 
                // 로컬: Loaded 이후 1회성 주입
#pragma warning disable CS1587 // Doxygen documents local functions; the C# compiler does not attach XML docs to them.
                void OnLoaded(object? s, RoutedEventArgs e)
                {
                    if (s is FrameworkElement fe)
                    {
                        fe.Loaded -= OnLoaded;
                        TrySet(fe);
                    }
                }
#pragma warning restore CS1587
 
                // 로컬: 네비게이션 직후 1회성 주입
#pragma warning disable CS1587 // Doxygen documents local functions; the C# compiler does not attach XML docs to them.
                void OnNavigated(object? s, NavigationEventArgs e)
                {
                    fr.Navigated -= OnNavigated;
 
                    if (fr.Content is FrameworkElement fe)
                    {
                        if (!fe.IsLoaded)
                        {
                            fe.Loaded += OnLoaded;
                        }
 
                        TrySet(fe);
                    }
                }
#pragma warning restore CS1587
 
                // 현재 시점에 컨텐츠가 있으면 즉시/Loaded에서 주입
                if (fr.Content is FrameworkElement current)
                {
                    if (!current.IsLoaded)
                    {
                        current.Loaded += OnLoaded;
                    }
 
                    TrySet(current);
                }
                else
                {
                    // 아직 Page가 없음 → 다음 네비게이션에서 주입
                    fr.Navigated += OnNavigated;
                }
 
                return;
            }
 
            // --- ContentControl 호스트 처리 ---
            if (root is ContentControl cc && cc.Content is FrameworkElement innerCc)
            {
                cc.DataContext = vm;
                innerCc.DataContext = vm;
                return;
            }
 
            // --- 일반 FrameworkElement 처리 ---
            root.DataContext = vm;
        }

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

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

GetTypesSafe()

Type[] Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.GetTypesSafe ( this Assembly asm )

inlinestaticprivate

로드 가능한 형식만 반환하여 부분적인 어셈블리 형식 로드 실패를 허용합니다.

매개변수

asm	형식을 열거할 어셈블리입니다.

반환값

어셈블리에서 성공적으로 로드된 형식 배열입니다.

예외

NullReferenceException

asm 가 null일 때 발생합니다.

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

        {
            try { return asm.GetTypes(); }
            catch (ReflectionTypeLoadException ex) { return ex.Types.Where(t => t != null).ToArray()!; }
        }

LoadViewWithViewModel()

LoadedViewInfo Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.LoadViewWithViewModel ( string typeName, bool useSingletonView )

inlinestatic

형식 이름으로 뷰를 만들고 규칙에 맞는 뷰 모델을 연결하여 로드 결과를 반환합니다.

매개변수

typeName	짧거나 정규화된 뷰 형식 이름이며 _Popup으로 끝날 수 있습니다.
useSingletonView	컨테이너에서 싱글톤 뷰 모델을 확인하려면 true입니다.

반환값

임베드 가능한 뷰와 뷰 모델 메타데이터입니다.

예외

ArgumentNullException	typeName 이 null일 때 발생합니다.
MissingMethodException	비싱글톤 뷰 모델에 매개변수 없는 생성자가 없을 때 발생할 수 있습니다.

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

        {
            // \brief Parse popup suffix
            bool isPopup = typeName.EndsWith("_Popup", StringComparison.OrdinalIgnoreCase);
            string actualTypeName = isPopup ? typeName[..^6] : typeName;
 
            // \brief 1) Resolve View type
            var viewType =
                Type.GetType(actualTypeName, throwOnError: false, ignoreCase: true)
                ?? AppDomain.CurrentDomain.GetAssemblies()
                    .SelectManySafe(a => a.GetTypesSafe())
                    .FirstOrDefault(t =>
                        t.FullName?.Equals(actualTypeName, StringComparison.OrdinalIgnoreCase) == true ||
                        t.Name.Equals(actualTypeName.Split('.').Last(), StringComparison.OrdinalIgnoreCase));
 
            // \brief 2) Resolve ViewModel type (FIXED)
            Type? viewModelType = ResolveViewModelType_Strict(actualTypeName, viewType);
 
            // \brief ViewModel exists => reset DataContext strategy may differ
            bool resetDataContext = viewModelType != null;
 
            object? vmInstance = null;
            string? uniqueKey = null;
 
            // \brief 3) Create/Resolve ViewModel instance
            if (viewModelType != null)
            {
                if (useSingletonView)
                {
                    vmInstance = DMContainer.Resolve(viewModelType) ?? Activator.CreateInstance(viewModelType);
                }
                else
                {
                    // \brief Multi instance unique key
                    long typeIndex = ViewModelKeyCache.GetOrIncrement(typeName);
                    uniqueKey = $"{typeName}_{typeIndex:D2}";
 
                    vmInstance = Activator.CreateInstance(viewModelType);
                }
            }
 
            // \brief 4) Create FrameworkElement
            FrameworkElement framework = ResolveFrameworkElement(viewType, actualTypeName, resetDataContext);
 
            // \brief 5) Apply DataContext when VM exists
            if (vmInstance != null)
            {
                ApplyDataContext(framework, vmInstance);
            }
 
            // \brief 6) Ensure wrapper as UserControl
            UserControl wrapper;
            if (framework is UserControl uc)
            {
                wrapper = uc;
            }
            else
            {
                wrapper = new EmbeddedHostControl(framework);
 
                // \note Ensure wrapper has same DataContext as the hosted framework
                if (wrapper.DataContext == null)
                {
                    wrapper.DataContext = framework.DataContext;
                }
            }
 
            return new LoadedViewInfo
            {
                View = wrapper,
                FrameworkView = framework,
                ViewModelType = viewModelType,
                IsPopup = isPopup,
                UniqueKey = uniqueKey
            };
        }

다음을 참조함 : ApplyDataContext(), Dreamine.UI.Wpf.Controls.ViewRegion.ViewModelKeyCache.GetOrIncrement(), ResolveFrameworkElement(), ResolveViewModelType_Strict().

다음에 의해서 참조됨 : Dreamine.UI.Wpf.Controls.DreamineTabHost.TryInitViews().

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

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

MergeResources()

void Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.MergeResources ( ResourceDictionary target, ResourceDictionary source )

inlinestaticprivate

원본 사전의 병합 사전과 중복되지 않는 리소스를 대상에 추가합니다.

매개변수

target	리소스를 받을 대상 사전입니다.
source	복사할 원본 사전입니다.

예외

NullReferenceException	target 또는 source 가 null일 때 발생합니다.
ArgumentException	대상 사전에 추가할 수 없는 키가 있을 때 발생할 수 있습니다.

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

        {
            foreach (var rd in source.MergedDictionaries)
                target.MergedDictionaries.Add(rd);
 
            foreach (var key in source.Keys)
                if (!target.Contains(key))
                    target.Add(key, source[key]);
        }

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

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

ResolveFrameworkElement()

FrameworkElement Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.ResolveFrameworkElement ( Type? viewType, string typeName, bool resetDataContext )

inlinestaticprivate

뷰 형식 인스턴스를 만들고 WPF 형식별 규칙에 따라 임베드 가능한 요소로 변환합니다.

매개변수

viewType	만들 뷰 형식이며 없으면 안내 요소를 반환합니다.
typeName	오류 안내에 사용할 뷰 형식 이름입니다.
resetDataContext	기존 데이터 컨텍스트를 제거하려면 true입니다.

반환값

사용자 컨트롤, 프레임, 콘텐츠 호스트 또는 안내 텍스트로 표현된 임베드 가능 요소입니다.

생성 실패는 안내용 TextBlock으로 변환되며 호출자에게 예외를 전파하지 않습니다.

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

        {
            if (viewType == null || viewType.IsAbstract)
            {
                return new TextBlock
                {
                    Text = $"[No View Type: {typeName}]",
                    Margin = new Thickness(8)
                };
            }
 
            object? instance = null;
 
            // 1차: VsControls를 통한 생성 시도 (항상 새 인스턴스)
            try
            {
                instance = DMContainer.Resolve(viewType);
            }
            catch (Exception ex)
            {
                System.Diagnostics.Debug.WriteLine($"[ViewLoader] VsContainer.Resolve 실패: {typeName} - {ex.Message}");
            }
 
            // 2차: 컨테이너 생성 실패 시 Activator.CreateInstance로 폴백
            if (instance == null)
            {
                try
                {
                    instance = Activator.CreateInstance(viewType);
                }
                catch (Exception ex)
                {
                    return new TextBlock
                    {
                        Text = $"[CreateInstance Failed: {typeName}] {ex.Message}",
                        Margin = new Thickness(8)
                    };
                }
            }
 
            switch (instance)
            {
                // --- UserControl 그대로 사용 ---
                case UserControl uc:
                    {
                        if (resetDataContext)
                        {
                            uc.DataContext = null;
                        }
                        return uc;
                    }
 
                // --- Page → Frame 호스팅 ---
                case Page page:
                    {
                        if (resetDataContext)
                        {
                            page.DataContext = null;
                        }
 
                        var frame = new Frame
                        {
                            Content = page,
                            NavigationUIVisibility = NavigationUIVisibility.Hidden,
                            JournalOwnership = JournalOwnership.OwnsJournal
                        };
 
                        if (resetDataContext)
                        {
                            frame.DataContext = null;
                        }
 
                        return frame;
                    }
 
                // --- Window → ContentControl 호스팅 ---
                case Window win:
                    {
                        if (win.Content is FrameworkElement content)
                        {
                            if (resetDataContext)
                            {
                                content.DataContext = null;
                                win.DataContext = null;
                            }
 
                            win.Content = null;
                            var host = new ContentControl
                            {
                                Content = content
                            };
 
                            if (resetDataContext)
                            {
                                host.DataContext = null;
                            }
 
                            MergeResources(host.Resources, win.Resources);
                            return host;
                        }
 
                        return new TextBlock
                        {
                            Text = $"[Window has no Content: {typeName}]",
                            Margin = new Thickness(8)
                        };
                    }
 
                // --- 기타 FrameworkElement ---
                case FrameworkElement fe:
                    {
                        if (resetDataContext)
                        {
                            fe.DataContext = null;
                        }
                        return fe;
                    }
 
                default:
                    {
                        return new TextBlock
                        {
                            Text = $"[Unknown View Type: {viewType.FullName}]",
                            Margin = new Thickness(8)
                        };
                    }
            }
        }

다음을 참조함 : MergeResources().

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

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

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

ResolveViewModelType_Strict()

? Type Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.ResolveViewModelType_Strict ( string actualTypeName, Type? viewType )

inlinestaticprivate

네임스페이스 및 접미사 후보 중 구체적인 ViewModelBase 파생 형식을 찾습니다.

매개변수

actualTypeName	_Popup 접미사를 제거한 실제 뷰 형식 이름입니다.
viewType	확인된 뷰 형식이며 찾지 못했으면 null입니다.

반환값

규칙과 기본 형식 조건을 만족하는 뷰 모델 형식이며 없으면 null입니다.

예외

ArgumentNullException

actualTypeName 이 null일 때 발생합니다.

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

        {
            // \brief Candidate full names
            var candidates = new List<string>();
 
            // \brief Common: same namespace + ViewModel suffix
            candidates.Add(actualTypeName + "ViewModel");
            candidates.Add(StripViewSuffix(actualTypeName) + "ViewModel");
 
            // \brief Pages -> ViewModels convention
            if (actualTypeName.Contains(".Pages.", StringComparison.OrdinalIgnoreCase))
            {
                var pagesToVm = actualTypeName.Replace(".Pages.", ".ViewModels.", StringComparison.OrdinalIgnoreCase);
                candidates.Add(pagesToVm + "ViewModel");
                candidates.Add(StripViewSuffix(pagesToVm) + "ViewModel");
            }
 
            // \brief Views -> ViewModels convention (optional, but common)
            if (actualTypeName.Contains(".Views.", StringComparison.OrdinalIgnoreCase))
            {
                var viewsToVm = actualTypeName.Replace(".Views.", ".ViewModels.", StringComparison.OrdinalIgnoreCase);
                candidates.Add(viewsToVm + "ViewModel");
                candidates.Add(StripViewSuffix(viewsToVm) + "ViewModel");
            }
 
            // \brief If viewType is known, add "Namespace.ViewModels.{ViewName}ViewModel"
            if (viewType != null)
            {
                string viewNs = viewType.Namespace ?? string.Empty;
                string viewName = viewType.Name;
                string viewNameNoSuffix = StripViewSuffix(viewName);
                if (!string.IsNullOrWhiteSpace(viewNs))
                {
                    candidates.Add($"{viewNs}.ViewModels.{viewName}ViewModel");
                    candidates.Add($"{viewNs}.ViewModels.{viewNameNoSuffix}ViewModel");
                    candidates.Add($"{viewNs}.{viewName}ViewModel");
                    candidates.Add($"{viewNs}.{viewNameNoSuffix}ViewModel");
 
                    // \brief Sibling "Views" -> "ViewModels" namespace swap
                    if (viewNs.Contains(".Views", StringComparison.OrdinalIgnoreCase))
                    {
                        string swappedNs = viewNs.Replace(".Views", ".ViewModels", StringComparison.OrdinalIgnoreCase);
                        candidates.Add($"{swappedNs}.{viewName}ViewModel");
                        candidates.Add($"{swappedNs}.{viewNameNoSuffix}ViewModel");
                    }
                }
 
                // \brief Short name candidates
                candidates.Add(viewName + "ViewModel");
                candidates.Add(viewNameNoSuffix + "ViewModel");
            }
 
            // \brief De-duplicate
            candidates = candidates
                .Where(x => !string.IsNullOrWhiteSpace(x))
                .Distinct(StringComparer.OrdinalIgnoreCase)
                .ToList();
 
            // \brief Search with strict filtering
            foreach (var cand in candidates)
            {
                var t = AppDomain.CurrentDomain.GetAssemblies()
                    .SelectManySafe(a => a.GetTypesSafe())
                    .FirstOrDefault(x =>
                        x.FullName?.Equals(cand, StringComparison.OrdinalIgnoreCase) == true ||
                        x.Name.Equals(cand.Split('.').Last(), StringComparison.OrdinalIgnoreCase));
 
                if (t == null)
                {
                    continue;
                }
 
                // \brief Must be a concrete class
                if (!t.IsClass || t.IsAbstract)
                {
                    continue;
                }
 
                // \brief Prevent selecting View type as ViewModel
                if (typeof(FrameworkElement).IsAssignableFrom(t))
                {
                    continue;
                }
 
                // \brief Strong filter: must be ViewModelBase (your framework)
                if (!typeof(ViewModelBase).IsAssignableFrom(t))
                {
                    continue;
                }
 
                return t;
            }
 
            return null;
        }

다음을 참조함 : StripViewSuffix().

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

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

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

SelectManySafe< T >()

IEnumerable< T > Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.SelectManySafe< T > ( this IEnumerable< Assembly > assemblies, Func< Assembly, IEnumerable< T > > selector )

inlinestaticprivate

동적 어셈블리를 건너뛰고 선택자 실패를 기록하면서 결과를 평탄화합니다.

템플릿 파라메터

T	선택자가 반환하는 요소 형식입니다.

매개변수

assemblies	검사할 어셈블리 시퀀스입니다.
selector	각 어셈블리에서 요소를 선택할 함수입니다.

반환값

성공한 선택 결과의 지연 시퀀스입니다.

예외

NullReferenceException

assemblies 또는 열거된 항목이 null일 때 발생할 수 있습니다.

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

        {
            foreach (var a in assemblies)
            {
                if (a.IsDynamic) continue;
                IEnumerable<T>? res = null;
                try { res = selector(a); }
                catch (Exception ex) { Debug.WriteLine($"[ViewLoader] Assembly scan 실패 ({a.FullName}): {ex.Message}"); }
                if (res != null) foreach (var x in res) yield return x;
            }
        }

StripViewSuffix()

string Dreamine.UI.Wpf.Controls.ViewRegion.ViewLoader.StripViewSuffix ( string name )

inlinestaticprivate

이름 끝의 View 접미사를 대소문자 구분 없이 제거합니다.

매개변수

name	검사할 형식 이름입니다.

반환값

접미사가 제거된 이름이며 접미사가 없으면 원래 이름입니다.

예외

NullReferenceException

name 이 null일 때 발생합니다.

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

        {
            const string suffix = "View";
            if (name.Length > suffix.Length && name.EndsWith(suffix, StringComparison.OrdinalIgnoreCase))
                return name[..^suffix.Length];
            return name;
        }

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

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

---

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

• ViewLoader.cs