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) с семантикой универсального кода ресурса (URI). Например, GetValue("Caption%20") обрабатывается как GetValue("Caption").

Не используйте символы "?" или "#" в идентификаторах ресурсов, так как они завершают оценку пути к ресурсу. Например, MyResource?3 трактуется как MyResource.

Свойства

Size	Возвращает количество ресурсов на карте.
Uri	Возвращает универсальный код ресурса (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>)	Разделяет представление карты на два представления.

См. также раздел

• Пример ресурсов и локализации приложения