ResourceMap Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.Resources.Core
Modifica

Raccolta di risorse correlate, in genere per un determinato pacchetto dell'app o un file di risorse per un determinato pacchetto.

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)
Ereditarietà
Object Platform::Object IInspectable ResourceMap
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute
Implementazioni
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>

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Questo esempio si basa sullo scenario 8 dell'esempio di localizzazione e risorse dell'applicazione. Vedere l'esempio per la soluzione completa.

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

Commenti

Sintassi dell'identificatore di risorsa

Molti metodi di questa classe usano gli identificatori di risorsa come parametri. L'identificatore di risorsa viene considerato come frammento URI (Uniform Resource Identifier), soggetto alla semantica URI (Uniform Resource Identifier). Ad esempio, GetValue("Caption%20") viene trattato come GetValue("Caption ").

Non usare "?" o "#" negli identificatori di risorsa, perché terminano la valutazione del percorso della risorsa. Ad esempio, "MyResource?3" viene considerato come "MyResource".

Proprietà

Size

Ottiene il numero di risorse nella mappa.
Uri

Ottiene un URI che può essere utilizzato per fare riferimento a questo Oggetto ResourceMap.

Metodi

First()

Restituisce un iteratore per enumerare gli elementi nella mappa.
GetSubtree(String)

Restituisce un oggetto ResourceMap che rappresenta una parte di un'altra ResourceMap, in genere usata per accedere a un determinato file di risorse all'interno di un pacchetto dell'app.

Questo metodo trova mappe sottoalbero, predecessore, di pari livello e cugino a questa mappa delle risorse, nonché mappe di primo livello. Restituisce la mappa delle risorse rappresentata da un identificatore di mappa delle risorse specificato, rispetto a questa mappa delle risorse. Questo metodo viene in genere usato per rendere più semplici riferimenti a un determinato subset di risorse, ad esempio un singolo file di risorse o una directory di file.
GetValue(String)

Nota

GetValue(String) può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetValue(String, ResourceContext).

Restituisce il candidato più appropriato per una risorsa specificata da un identificatore di risorsa all'interno del contesto predefinito.
GetValue(String, ResourceContext)

Restituisce il candidato più appropriato per una risorsa specificata da un identificatore di risorsa per il contesto fornito.
HasKey(String)

Determina se la mappa può recuperare una risorsa con l'identificatore di risorsa specificato.
Lookup(String)

Restituisce l'oggetto NamedResource in corrispondenza dell'identificatore di risorsa specificato nella mappa.
Split(IMapView<String,NamedResource>, IMapView<String,NamedResource>)

Suddivide la visualizzazione mappa in due visualizzazioni.

Si applica a

Vedi anche