ResourceLoader 클래스

정의

네임스페이스:

Windows.ApplicationModel.Resources

앱 UI 문자열과 같은 앱 리소스에 대한 간소화된 액세스를 제공합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public ref class ResourceLoader sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Resources.IResourceLoaderFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ResourceLoader final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.Resources.IResourceLoaderFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ResourceLoader

function ResourceLoader(name)

Public NotInheritable Class ResourceLoader

상속

Object Platform::Object IInspectable ResourceLoader

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

ResourceLoader.GetString 메서드를 사용하여 "Farewell"로 식별된 문자열 리소스를 가져옵니다.

var resourceLoader = Windows.ApplicationModel.Resources.ResourceLoader.GetForCurrentView();
var text = resourceLoader.GetString("Farewell");

auto resourceLoader{ Windows::ApplicationModel::Resources::ResourceLoader::GetForCurrentView() };
winrt::hstring text{ resourceLoader.GetString(L"Farewell") };

auto resourceLoader = Windows::ApplicationModel::Resources::ResourceLoader::GetForCurrentView();
String^ text = resourceLoader->GetString("Farewell");

설명

ResourceLoader 개체는 간단한 API로 결합된 특정 ResourceMap 및 ResourceContext를 캡슐화합니다.

ResourceLoader를 가져올 때 특정 리소스 맵을 지정할 수 있습니다. 리소스 맵이 지정되지 않은 경우 ResourceLoader는 앱의 기본 리소스 맵의 "리소스" 하위 트리에 대한 액세스를 제공합니다.

일반적으로 리소스는 크기 조정 또는 기타 표시 특성에 민감할 수 있습니다. 이러한 이유로 리소스 컨텍스트는 일반적으로 특정 보기와 연결됩니다. ResourceLoader는 리소스 컨텍스트를 캡슐화하므로 ResourceLoader에도 적용됩니다. GetForCurrentView를 사용하여 얻은 ResourceLoader에는 가져온 뷰와 연결된 리소스 컨텍스트가 있습니다. GetForViewIndependentUse를 사용하여 보기 독립적 ResourceLoader를 가져올 수도 있습니다.

• 사용되지 않는 DisplayProperties 클래스 대신 DisplayInformation 클래스를 사용하여 현재 보기의 배율 인수를 가져옵니다.
• 요소의 명시적 너비와 높이를 설정하는 앱은 흐릿한 이미지를 표시하는 것 외에는 여전히 제대로 작동해야 합니다.
• GetForViewIndependentUse를 통해 ResourceLoader를 가져와 보기와 연결되지 않은 리소스를 가져옵니다.

화면 크기 및 중단점도 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1903	18362	GetForUIContext

생성자

ResourceLoader()	참고 ResourceLoader()는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 GetForCurrentView()를 사용합니다. 현재 실행 중인 앱의 기본 ResourceMap의 "Resources" 하위 트리에 대한 새 ResourceLoader 개체를 생성합니다. UWP에 해당하는 WinUI 2 API: ResourceLoader()(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ResourceLoader(String)	참고 ResourceLoader(String)는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없습니다. 대신 GetForCurrentView(String)를 사용합니다. 지정된 ResourceMap에 대한 새 ResourceLoader 개체를 생성합니다. UWP에 해당하는 WinUI 2 API: ResourceLoader(String)(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

메서드

GetDefaultPriPath(String)	앱에 대한 파일의 resources.pri 위치를 제공합니다.
GetForCurrentView()	현재 실행 중인 앱의 기본 ResourceMap의 Resources 하위 트리에 대한 ResourceLoader 개체를 가져옵니다. 이 ResourceLoader 는 현재 보기와 연결된 기본 컨텍스트를 사용합니다.
GetForCurrentView(String)	지정된 ResourceMap에 대한 ResourceLoader 개체를 가져옵니다. 이 ResourceLoader 는 현재 보기와 연결된 기본 컨텍스트를 사용합니다.
GetForUIContext(UIContext)	지정된 UIContext에 대한 ResourceLoader 개체를 가져옵니다.
GetForViewIndependentUse()	현재 실행 중인 앱의 기본 ResourceMap의 Resources 하위 트리에 대한 ResourceLoader 개체를 가져옵니다. 이 ResourceLoader 는 보기와 연결되지 않은 기본 컨텍스트를 사용합니다.
GetForViewIndependentUse(String)	지정된 ResourceMap에 대한 ResourceLoader 개체를 가져옵니다. 이 ResourceLoader 는 보기와 연결되지 않은 기본 컨텍스트를 사용합니다.
GetString(String)	ResourceLoader.GetForCurrentView를 사용하여 ResourceLoader를 가져온 보기의 기본 ResourceContext에 대해 리소스 식별자가 지정한 리소스의 가장 적절한 문자열 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
GetStringForReference(Uri)	참고 GetStringForReference는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없습니다. 대신 GetStringForUri를 사용합니다. 현재 실행 중인 앱의 기본 ResourceContext에 대해 리소스 식별자에 대한 Uri로 지정된 리소스의 가장 적절한 문자열 값을 반환합니다.
GetStringForUri(Uri)	현재 실행 중인 앱의 기본 ResourceContext 에 대해 URI(Uniform Resource Identifier) 리소스 식별자에 의해 지정된 리소스의 가장 적절한 문자열 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

추가 정보

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• 앱 리소스 및 리소스 관리 시스템
• 애플리케이션 리소스 및 지역화 샘플