ResourceMap Klasse

Definition

Namespace:

Windows.ApplicationModel.Resources.Core

Eine Sammlung verwandter Ressourcen, in der Regel entweder für ein bestimmtes App-Paket oder eine Ressourcendatei für ein bestimmtes Paket.

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)

Vererbung

Object Platform::Object IInspectable ResourceMap

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Dieses Beispiel basiert auf Szenario 8 des Anwendungsressourcen- und Lokalisierungsbeispiels. Sehen Sie sich das Beispiel für die vollständige Lösung an.

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

Hinweise

Syntax des Ressourcenbezeichners

Viele Methoden dieser Klasse verwenden Ressourcenbezeichner als Parameter. Der Ressourcenbezeichner wird als URI-Fragment (Uniform Resource Identifier) behandelt, vorbehaltlich der URI-Semantik (Uniform Resource Identifier). Beispielsweise wird GetValue("Caption%20") als GetValue("Caption ") behandelt.

Verwenden Sie nicht "?" oder "#" in Ressourcenbezeichnern, da sie die Auswertung des Ressourcenpfads beenden. Beispielsweise wird "MyResource?3" als "MyResource" behandelt.

Eigenschaften

Size	Ruft die Anzahl der Ressourcen in der Zuordnung ab.
Uri	Ruft einen URI ab, der verwendet werden kann, um auf diese ResourceMap zu verweisen.

Methoden

First()	Gibt einen Iterator zurück, um die Elemente in der Zuordnung aufzulisten.
GetSubtree(String)	Gibt eine ResourceMap zurück, die einen Teil einer anderen ResourceMap darstellt, die normalerweise für den Zugriff auf eine bestimmte Ressourcendatei innerhalb eines App-Pakets verwendet wird. Diese Methode sucht nach Unterstruktur-, Vorgänger-, Gleichgeordneten- und Cousinzuordnungen zu dieser Ressourcenzuordnung sowie nach Zuordnungen auf oberster Ebene. Es gibt die Ressourcenzuordnung zurück, die durch einen angegebenen Ressourcenzuordnungsbezeichner relativ zu dieser Ressourcenzuordnung dargestellt wird. Diese Methode wird in der Regel verwendet, um einfachere Verweise auf eine bestimmte Teilmenge von Ressourcen zu erstellen, z. B. eine einzelne Ressourcendatei oder ein Verzeichnis mit Dateien.
GetValue(String)	Hinweis GetValue(String) kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen GetValue(String, ResourceContext). Gibt den am besten geeigneten Kandidaten für eine Ressource zurück, die durch einen Ressourcenbezeichner im Standardkontext angegeben wird.
GetValue(String, ResourceContext)	Gibt den am besten geeigneten Kandidaten für eine Ressource zurück, die durch einen Ressourcenbezeichner für den angegebenen Kontext angegeben wird.
HasKey(String)	Bestimmt, ob die Zuordnung eine Ressource mit dem angegebenen Ressourcenbezeichner abrufen kann.
Lookup(String)	Gibt die NamedResource am angegebenen Ressourcenbezeichner in der Zuordnung zurück.
Split(IMapView<String,NamedResource>, IMapView<String,NamedResource>)	Teilt die Kartenansicht in zwei Ansichten auf.

Weitere Informationen

• Anwendungsressourcen und Lokalisierung – Beispiel