ResourceMap 클래스

정의

네임스페이스:

Windows.ApplicationModel.Resources.Core

일반적으로 특정 앱 패키지의 경우 또는 특정 패키지에 대한 리소스 파일과 관련된 리소스의 컬렉션입니다.

public ref class ResourceMap sealed : IIterable<IKeyValuePair<Platform::String ^, NamedResource ^> ^>, IMapView<Platform::String ^, NamedResource ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ResourceMap final : IIterable<IKeyValuePair<winrt::hstring, NamedResource const&>>, IMapView<winrt::hstring, NamedResource const&>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ResourceMap : IEnumerable<KeyValuePair<string,NamedResource>>, IReadOnlyDictionary<string,NamedResource>

Public NotInheritable Class ResourceMap
Implements IEnumerable(Of KeyValuePair(Of String, NamedResource)), IReadOnlyDictionary(Of String, NamedResource)

상속

Object Platform::Object IInspectable ResourceMap

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,NamedResource>> IIterable<IKeyValuePair<Platform::String,NamedResource>> IIterable<IKeyValuePair<winrt::hstring,NamedResource>> IReadOnlyDictionary<String,NamedResource> IMapView<Platform::String,NamedResource> IMapView<winrt::hstring,NamedResource>

Windows 요구 사항

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

예제

이 예제는 애플리케이션 리소스 및 지역화 샘플의 시나리오 8을 기반으로 합니다. 전체 솔루션은 샘플을 참조하세요.

private void ShowText()
{
    ResourceContext defaultContextForCurrentView = ResourceContext.GetForCurrentView();
    ResourceMap stringResourcesResourceMap = ResourceManager.Current.MainResourceMap.GetSubtree("Resources");
    Scenario8MessageTextBlock.Text = stringResourcesResourceMap.GetValue("string1", defaultContextForCurrentView).ValueAsString;
}

void Scenario8::ShowText()
{
    ResourceContext^ defaultContextForCurrentView = ResourceContext::GetForCurrentView();
    auto resourceStringMap = ResourceManager::Current->MainResourceMap->GetSubtree("Resources");
    Scenario8MessageTextBlock->Text = resourceStringMap->GetValue("string1", defaultContextForCurrentView)->ValueAsString;
}

설명

리소스 식별자 구문

이 클래스의 많은 메서드는 리소스 식별자를 매개 변수로 사용합니다. 리소스 식별자는 URI(Uniform Resource Identifier) 의미 체계에 따라 URI(Uniform Resource Identifier) 조각으로 처리됩니다. 예를 들어 GetValue("Caption%20")는 GetValue("Caption ")로 처리됩니다.

"?" 또는 "#"는 리소스 경로 평가를 종료하므로 사용하지 마세요. 예를 들어 "MyResource?3"은 "MyResource"로 처리됩니다.

속성

Size	맵의 리소스 수를 가져옵니다.
Uri	이 ResourceMap을 참조하는 데 사용할 수 있는 URI를 가져옵니다.

메서드

First()	맵의 항목을 열거하는 반복기를 반환합니다.
GetSubtree(String)	일반적으로 앱 패키지 내의 특정 리소스 파일에 액세스하는 데 사용되는 다른 ResourceMap의 일부를 나타내는 ResourceMap을 반환합니다. 이 메서드는 하위 트리, 상위 항목, 형제 및 사촌 맵과 최상위 맵을 찾습니다. 이 리소스 맵을 기준으로 지정된 리소스 맵 식별자가 나타내는 리소스 맵을 반환합니다. 이 메서드는 일반적으로 단일 리소스 파일 또는 파일 디렉터리와 같은 리소스의 특정 하위 집합에 대한 간단한 참조를 만드는 데 사용됩니다.
GetValue(String)	참고 GetValue(String)는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 GetValue(String, ResourceContext)를 사용합니다. 기본 컨텍스트 내에서 리소스 식별자에 의해 지정된 리소스에 가장 적합한 후보를 반환합니다.
GetValue(String, ResourceContext)	제공된 컨텍스트에 대한 리소스 식별자에 의해 지정된 리소스에 가장 적합한 후보를 반환합니다.
HasKey(String)	맵이 지정된 리소스 식별자를 사용하여 리소스를 검색할 수 있는지 여부를 결정합니다.
Lookup(String)	맵의 지정된 리소스 식별자에서 NamedResource 를 반환합니다.
Split(IMapView<String,NamedResource>, IMapView<String,NamedResource>)	지도 보기를 두 개의 보기로 분할합니다.

추가 정보

• 애플리케이션 리소스 및 지역화 샘플