ResourceMap クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.Resources.Core

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

通常、特定のアプリパッケージの場合は関連リソースのコレクション、または特定のパッケージのリソースファイル。

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;
}

注釈

リソース識別子の構文

このクラスの多くのメソッドは、リソース識別子をパラメーターとして使用します。リソース識別子は、Uniform Resource Identifier (URI) セマンティクスに従って、Uniform Resource Identifier (URI) フラグメントとして扱われます。たとえば、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>)	マップビューを 2 つのビューに分割します。

適用対象

こちらもご覧ください

アプリリソースとローカライズのサンプル

次の方法で共有