정적 Public 멤버 함수
static void	Register (Type viewType, Type viewModelType)
static void	RegisterResolver (IViewModelResolver resolver)
static void	ClearResolver ()
static void	Clear ()
static void	Reset ()
static ? object	Resolve (Type viewType)
static ? object	ResolveView (Type viewModelType)
static void	RegisterAll (Assembly assembly)

정적 Private 멤버 함수
static	ViewModelLocator ()
static ? Type	FindViewModelType (Type viewType, Type[]? cachedTypes=null)
static Type[]	GetAllLoadableTypes ()
static IEnumerable< Type >	GetLoadableTypes (Assembly assembly)
static ? Type	FindViewType (Type viewModelType)
static ? object	CreateInstance (Type type)
static void	ClearTypeCache ()

정적 Private 속성
static readonly object	_syncRoot = new()
static readonly Dictionary< Type, Type >	_map = new(32)
static readonly Dictionary< Type, Type?>	_viewModelTypeCache = new(32)
static readonly Dictionary< Type, Type?>	_viewTypeCache = new(32)
static ? IViewModelResolver	_resolver
static ? Type[]	_allLoadableTypesCache

상세한 설명

View와 ViewModel 간의 타입 매핑 및 인스턴스 생성을 이름과 네임스페이스 규칙으로 지원합니다.

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

생성자 & 소멸자 문서화

◆ ViewModelLocator()

Dreamine.MVVM.Locators.ViewModelLocator.ViewModelLocator ( )

inlinestaticprivate

어셈블리 로드 시 타입 검색 캐시가 초기화되도록 로케이터를 구성합니다.

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

        {
            AppDomain.CurrentDomain.AssemblyLoad += (_, _) => ClearTypeCache();
        }

다음을 참조함 : ClearTypeCache().

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

멤버 함수 문서화

◆ Clear()

void Dreamine.MVVM.Locators.ViewModelLocator.Clear ( )

inlinestatic

구성된 확인자는 유지하고 등록된 매핑과 타입 검색 캐시를 지웁니다.

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

        {
            lock (_syncRoot)
            {
                _map.Clear();
                _viewModelTypeCache.Clear();
                _viewTypeCache.Clear();
                _allLoadableTypesCache = null;
            }
        }

다음을 참조함 : _allLoadableTypesCache, _map, _syncRoot, _viewModelTypeCache, _viewTypeCache.

◆ ClearResolver()

void Dreamine.MVVM.Locators.ViewModelLocator.ClearResolver ( )

inlinestatic

구성된 ViewModel 확인자를 제거합니다.

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

        {
            lock (_syncRoot)
            {
                _resolver = null;
            }
        }

다음을 참조함 : _resolver, _syncRoot.

◆ ClearTypeCache()

void Dreamine.MVVM.Locators.ViewModelLocator.ClearTypeCache ( )

inlinestaticprivate

View 및 ViewModel 타입 검색 캐시를 지웁니다.

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

        {
            lock (_syncRoot)
            {
                _viewModelTypeCache.Clear();
                _viewTypeCache.Clear();
                _allLoadableTypesCache = null;
            }
        }

다음을 참조함 : _allLoadableTypesCache, _syncRoot, _viewModelTypeCache, _viewTypeCache.

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

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

◆ CreateInstance()

? object Dreamine.MVVM.Locators.ViewModelLocator.CreateInstance ( Type type )

inlinestaticprivate

구성된 확인자를 사용해 지정한 타입의 인스턴스를 생성합니다.

매개변수

type	생성할 타입입니다.

반환값: 확인자가 생성한 인스턴스입니다.

예외

InvalidOperationException 확인자가 구성되지 않았거나 타입을 확인하지 못한 경우 발생합니다.

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

        {
            System.Diagnostics.Debug.WriteLine($"[ViewModelLocator] CreateInstance: {type.FullName}");
 
            IViewModelResolver? resolver;
            lock (_syncRoot)
            {
                resolver = _resolver;
            }
 
            if (resolver is null)
            {
                throw new InvalidOperationException(
                    $"Cannot resolve ViewModel [{type.FullName}] because no ViewModel resolver is configured. " +
                    "Call ViewModelLocator.RegisterResolver(...) or configure DreamineAppBuilder to use the default DMContainer resolver.");
            }
 
            var resolved = resolver.Resolve(type);
            if (resolved is not null)
            {
                return resolved;
            }
 
            throw new InvalidOperationException(
                $"Cannot resolve ViewModel [{type.FullName}]. " +
                "The type was not resolved by the configured resolver. " +
                "Register the ViewModel in the configured container or replace the ViewModelLocator resolver.");
        }

다음을 참조함 : _resolver, _syncRoot.

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

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

◆ FindViewModelType()

? Type Dreamine.MVVM.Locators.ViewModelLocator.FindViewModelType	(	Type	viewType,
		Type?[]	cachedTypes = null )

inlinestaticprivate

이름 규칙과 선택적 타입 목록을 사용해 View에 대응하는 ViewModel 타입을 찾습니다.

매개변수

viewType	View 타입입니다.
cachedTypes	선택적으로 미리 확보한 검색 타입 목록입니다.

반환값: 대응하는 ViewModel 타입이며, 찾지 못하면 null입니다.

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

        {
            if (cachedTypes is null)
            {
                lock (_syncRoot)
                {
                    if (_viewModelTypeCache.TryGetValue(viewType, out Type? cachedViewModelType))
                    {
                        return cachedViewModelType;
                    }
                }
            }
 
            Type[] allTypes = cachedTypes ?? GetAllLoadableTypes();
            string[] candidateNames = ViewNamingConvention.GetViewModelTypeNameCandidates(viewType);
 
            foreach (string candidateName in candidateNames)
            {
                Type? match = allTypes.FirstOrDefault(t =>
                    t.FullName == candidateName ||
                    t.Name == candidateName);
 
                if (match != null)
                {
                    if (cachedTypes is null)
                    {
                        lock (_syncRoot)
                        {
                            _viewModelTypeCache[viewType] = match;
                        }
                    }
 
                    return match;
                }
            }
 
            if (cachedTypes is null)
            {
                lock (_syncRoot)
                {
                    _viewModelTypeCache[viewType] = null;
                }
            }
 
            return null;
        }

다음을 참조함 : _syncRoot, _viewModelTypeCache, GetAllLoadableTypes(), Dreamine.MVVM.Locators.ViewNamingConvention.GetViewModelTypeNameCandidates().

다음에 의해서 참조됨 : RegisterAll(), Resolve().

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

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

◆ FindViewType()

? Type Dreamine.MVVM.Locators.ViewModelLocator.FindViewType ( Type viewModelType )

inlinestaticprivate

이름 규칙에 따라 ViewModel 타입에 대응하는 View 타입을 찾습니다.

매개변수

viewModelType ViewModel 타입입니다.

반환값: 대응하는 View 타입이며, 찾지 못하면 null입니다.

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

        {
            lock (_syncRoot)
            {
                if (_viewTypeCache.TryGetValue(viewModelType, out Type? cachedViewType))
                {
                    return cachedViewType;
                }
            }
 
            Type[] allTypes = GetAllLoadableTypes();
            string[] candidateNames = ViewNamingConvention.GetViewTypeNameCandidates(viewModelType);
 
            foreach (string candidateName in candidateNames)
            {
                Type? match = allTypes.FirstOrDefault(t =>
                    t.FullName == candidateName ||
                    t.Name == candidateName);
 
                if (match != null)
                {
                    lock (_syncRoot)
                    {
                        _viewTypeCache[viewModelType] = match;
                    }
 
                    return match;
                }
            }
 
            lock (_syncRoot)
            {
                _viewTypeCache[viewModelType] = null;
            }
 
            return null;
        }

다음을 참조함 : _syncRoot, _viewTypeCache, GetAllLoadableTypes(), Dreamine.MVVM.Locators.ViewNamingConvention.GetViewTypeNameCandidates().

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

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

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

◆ GetAllLoadableTypes()

Type[] Dreamine.MVVM.Locators.ViewModelLocator.GetAllLoadableTypes ( )

inlinestaticprivate

현재 AppDomain의 모든 비동적 어셈블리에서 로드 가능한 구체 클래스 타입을 가져옵니다.

반환값: 캐시된 로드 가능 타입 배열입니다.

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

        {
            lock (_syncRoot)
            {
                if (_allLoadableTypesCache is not null)
                {
                    return _allLoadableTypesCache;
                }
            }
 
            Type[] types = AppDomain.CurrentDomain
                    .GetAssemblies()
                    .Where(assembly => !assembly.IsDynamic)
                    .SelectMany(GetLoadableTypes)
                    .Where(type => type is { IsClass: true, IsAbstract: false })
                    .ToArray();
 
            lock (_syncRoot)
            {
                _allLoadableTypesCache ??= types;
                return _allLoadableTypesCache;
            }
        }

다음을 참조함 : _allLoadableTypesCache, _syncRoot, GetLoadableTypes().

다음에 의해서 참조됨 : FindViewModelType(), FindViewType().

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

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

◆ GetLoadableTypes()

IEnumerable< Type > Dreamine.MVVM.Locators.ViewModelLocator.GetLoadableTypes ( Assembly assembly )

inlinestaticprivate

지정한 어셈블리에서 로드 가능한 타입만 가져옵니다.

매개변수

assembly 검색할 어셈블리입니다.

반환값: 로드 가능한 타입 시퀀스이며, 조회 실패 시 빈 시퀀스입니다.

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

        {
            try
            {
                return assembly.GetTypes();
            }
            catch (ReflectionTypeLoadException ex)
            {
                return ex.Types.Where(type => type != null)!;
            }
            catch
            {
                return Array.Empty<Type>();
            }
        }

다음에 의해서 참조됨 : GetAllLoadableTypes(), RegisterAll().

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

◆ Register()

void Dreamine.MVVM.Locators.ViewModelLocator.Register	(	Type	viewType,
		Type	viewModelType )

inlinestatic

View와 ViewModel 타입 매핑을 수동으로 등록합니다.

매개변수

viewType	View 타입입니다.
viewModelType	ViewModel 타입입니다.

예외

ArgumentNullException 인수 중 하나가 null인 경우 발생합니다.

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

        {
            ArgumentNullException.ThrowIfNull(viewType);
            ArgumentNullException.ThrowIfNull(viewModelType);
 
            lock (_syncRoot)
            {
                _map[viewType] = viewModelType;
                _viewModelTypeCache[viewType] = viewModelType;
            }
        }

다음을 참조함 : _map, _syncRoot, _viewModelTypeCache.

다음에 의해서 참조됨 : RegisterAll(), Resolve().

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

◆ RegisterAll()

void Dreamine.MVVM.Locators.ViewModelLocator.RegisterAll ( Assembly assembly )

inlinestatic

지정된 어셈블리에서 View와 ViewModel 매핑을 자동으로 등록합니다.

매개변수

assembly 검색할 어셈블리입니다.

예외

ArgumentNullException assembly 가 null인 경우 발생합니다.

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

        {
            ArgumentNullException.ThrowIfNull(assembly);
 
            Type[] allTypes = GetLoadableTypes(assembly)
                .Where(t => t is { IsClass: true, IsAbstract: false })
                .ToArray();
 
            IEnumerable<Type> viewCandidates = allTypes.Where(ViewNamingConvention.IsLikelyViewType);
 
            foreach (Type viewType in viewCandidates)
            {
                bool alreadyRegistered;
                lock (_syncRoot)
                {
                    alreadyRegistered = _map.ContainsKey(viewType);
                }
 
                if (alreadyRegistered)
                {
                    continue;
                }
 
                Type? viewModelType = FindViewModelType(viewType, allTypes);
                if (viewModelType != null)
                {
                    Register(viewType, viewModelType);
                }
            }
        }

다음을 참조함 : _map, _syncRoot, FindViewModelType(), GetLoadableTypes(), Dreamine.MVVM.Locators.ViewNamingConvention.IsLikelyViewType(), Register().

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

◆ RegisterResolver()

void Dreamine.MVVM.Locators.ViewModelLocator.RegisterResolver ( IViewModelResolver resolver )

inlinestatic

외부 ViewModel 확인자를 등록합니다.

매개변수

resolver 등록할 확인자 구현입니다.

예외

ArgumentNullException resolver 가 null인 경우 발생합니다.

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

        {
            ArgumentNullException.ThrowIfNull(resolver);
 
            lock (_syncRoot)
            {
                _resolver = resolver;
            }
        }

다음을 참조함 : _resolver, _syncRoot.

◆ Reset()

void Dreamine.MVVM.Locators.ViewModelLocator.Reset ( )

inlinestatic

등록된 매핑, 타입 검색 캐시 및 확인자를 포함한 모든 로케이터 상태를 초기화합니다.

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

        {
            lock (_syncRoot)
            {
                _map.Clear();
                _viewModelTypeCache.Clear();
                _viewTypeCache.Clear();
                _allLoadableTypesCache = null;
                _resolver = null;
            }
        }

다음을 참조함 : _allLoadableTypesCache, _map, _resolver, _syncRoot, _viewModelTypeCache, _viewTypeCache.

◆ Resolve()

? object Dreamine.MVVM.Locators.ViewModelLocator.Resolve ( Type viewType )

inlinestatic

View 타입에 대응하는 ViewModel 인스턴스를 확인합니다.

매개변수

viewType View 타입입니다.

반환값: 확인된 ViewModel 인스턴스이며, 타입을 찾지 못하면 null입니다.

예외

ArgumentNullException	viewType 이 `null`인 경우 발생합니다.
InvalidOperationException	확인자가 없거나 일치하는 인스턴스를 만들지 못한 경우 발생합니다.

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

        {
            ArgumentNullException.ThrowIfNull(viewType);
 
            Type? mappedType;
            lock (_syncRoot)
            {
                _map.TryGetValue(viewType, out mappedType);
            }
 
            if (mappedType is not null)
            {
                return CreateInstance(mappedType);
            }
 
            Type? resolvedType = FindViewModelType(viewType);
            if (resolvedType is null)
            {
                return null;
            }
 
            Register(viewType, resolvedType);
            return CreateInstance(resolvedType);
        }

다음을 참조함 : _map, _syncRoot, CreateInstance(), FindViewModelType(), Register().

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

◆ ResolveView()

? object Dreamine.MVVM.Locators.ViewModelLocator.ResolveView ( Type viewModelType )

inlinestatic

ViewModel 타입에 대응하는 View 인스턴스를 생성합니다.

매개변수

viewModelType ViewModel 타입입니다.

반환값: 생성된 View 인스턴스이며, 타입을 찾지 못하면 null입니다.

예외

ArgumentNullException viewModelType 이 null인 경우 발생합니다.

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

        {
            ArgumentNullException.ThrowIfNull(viewModelType);
 
            Type? viewType = FindViewType(viewModelType);
            return viewType != null
                ? Activator.CreateInstance(viewType)
                : null;
        }

다음을 참조함 : FindViewType().

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

멤버 데이터 문서화

◆ _allLoadableTypesCache

? Type [] Dreamine.MVVM.Locators.ViewModelLocator._allLoadableTypesCache

staticprivate

all Loadable Types Cache 값을 보관합니다.

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

다음에 의해서 참조됨 : Clear(), ClearTypeCache(), GetAllLoadableTypes(), Reset().

◆ _map

readonly Dictionary<Type, Type> Dreamine.MVVM.Locators.ViewModelLocator._map = new(32)

staticprivate

map 값을 보관합니다.

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

다음에 의해서 참조됨 : Clear(), Register(), RegisterAll(), Reset(), Resolve().

◆ _resolver

? IViewModelResolver Dreamine.MVVM.Locators.ViewModelLocator._resolver

staticprivate

resolver 값을 보관합니다.

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

다음에 의해서 참조됨 : ClearResolver(), CreateInstance(), RegisterResolver(), Reset().

◆ _syncRoot

readonly object Dreamine.MVVM.Locators.ViewModelLocator._syncRoot = new()

staticprivate

sync Root 값을 보관합니다.

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

다음에 의해서 참조됨 : Clear(), ClearResolver(), ClearTypeCache(), CreateInstance(), FindViewModelType(), FindViewType(), GetAllLoadableTypes(), Register(), RegisterAll(), RegisterResolver(), Reset(), Resolve().

◆ _viewModelTypeCache

readonly Dictionary<Type, Type?> Dreamine.MVVM.Locators.ViewModelLocator._viewModelTypeCache = new(32)

staticprivate

view Model Type Cache 값을 보관합니다.

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

다음에 의해서 참조됨 : Clear(), ClearTypeCache(), FindViewModelType(), Register(), Reset().

◆ _viewTypeCache

readonly Dictionary<Type, Type?> Dreamine.MVVM.Locators.ViewModelLocator._viewTypeCache = new(32)

staticprivate

view Type Cache 값을 보관합니다.

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

다음에 의해서 참조됨 : Clear(), ClearTypeCache(), FindViewType(), Reset().

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

ViewModelLocator.cs

정적 Public 멤버 함수

정적 Private 멤버 함수

정적 Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ ViewModelLocator()

멤버 함수 문서화

◆ Clear()

◆ ClearResolver()

◆ ClearTypeCache()

◆ CreateInstance()

◆ FindViewModelType()

◆ FindViewType()

◆ GetAllLoadableTypes()

◆ GetLoadableTypes()

◆ Register()

◆ RegisterAll()

◆ RegisterResolver()

◆ Reset()

◆ Resolve()

◆ ResolveView()

멤버 데이터 문서화

◆ _allLoadableTypesCache

◆ _map

◆ _resolver

◆ _syncRoot

◆ _viewModelTypeCache

◆ _viewTypeCache