Partage via


ResourceMap Classe

Définition

Collection de ressources associées, généralement pour un package d’application particulier ou un fichier de ressources pour un package particulier.

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)
Héritage
Object Platform::Object IInspectable ResourceMap
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple est basé sur le scénario 8 de l’exemple ressources d’application et de localisation. Consultez l’exemple pour obtenir la solution complète.

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

Remarques

Syntaxe de l’identificateur de ressource

De nombreuses méthodes de cette classe utilisent des identificateurs de ressource comme paramètres. L’identificateur de ressource est traité comme un fragment URI (Uniform Resource Identifier), soumis à la sémantique uri (Uniform Resource Identifier). Par exemple, GetValue(« Caption%20 ») est traité comme GetValue(« Caption »).

N’utilisez pas « ? » ou « # » dans les identificateurs de ressource, car ils mettent fin à l’évaluation du chemin d’accès aux ressources. Par exemple, « MyResource?3 » est traité comme « MyResource ».

Propriétés

Size

Obtient le nombre de ressources dans la carte.

Uri

Obtient un URI qui peut être utilisé pour faire référence à ce ResourceMap.

Méthodes

First()

Retourne un itérateur pour énumérer les éléments dans la carte.

GetSubtree(String)

Retourne un ResourceMap qui représente une partie d’un autre ResourceMap, généralement utilisé pour accéder à un fichier de ressources particulier dans un package d’application.

Cette méthode recherche les sous-arborescences, ancêtres, frères et cousins à cette carte de ressources, ainsi que les cartes de niveau supérieur. Elle retourne la carte de ressources représentée par un identificateur de carte de ressources donné, relative à cette carte de ressources. Cette méthode est généralement utilisée pour faire des références plus simples à un sous-ensemble particulier de ressources, tel qu’un fichier de ressources unique ou un répertoire de fichiers.

GetValue(String)

Notes

GetValue(String) peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetValue(String, ResourceContext).

Retourne le candidat le plus approprié pour une ressource spécifiée par un identificateur de ressource dans le contexte par défaut.

GetValue(String, ResourceContext)

Retourne le candidat le plus approprié pour une ressource spécifiée par un identificateur de ressource pour le contexte fourni.

HasKey(String)

Détermine si la carte peut récupérer une ressource avec l’identificateur de ressource spécifié.

Lookup(String)

Retourne la NamedResource à l’identificateur de ressource spécifié dans la carte.

Split(IMapView<String,NamedResource>, IMapView<String,NamedResource>)

Fractionne la vue cartographique en deux vues.

S’applique à

Voir aussi