ResourceManager Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit l’accès aux mappages de ressources d’application et aux fonctionnalités de ressources plus avancées.
public ref class ResourceManager sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ResourceManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ResourceManager
Public NotInheritable Class ResourceManager
- Héritage
- Attributs
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 10 de l’exemple ressources d’application et de localisation. Consultez l’exemple pour obtenir la solution la plus complète.
private void SearchMultipleResourceIds(string language, string scale, string contrast, string homeRegion)
{
// use a cloned context for this scenario so that qualifier values set
// in this scenario don't impact behavior in other scenarios that
// use a default context for the view (crossover effects between
// the scenarios will not be expected)
ResourceContext context = ResourceContext.GetForCurrentView().Clone();
context.QualifierValues["language"] = language;
context.QualifierValues["scale"] = scale;
context.QualifierValues["contrast"] = contrast;
context.QualifierValues["homeregion"] = homeRegion;
var resourceIds = new string[] { "LanguageOnly", "ScaleOnly", "ContrastOnly", "HomeRegionOnly", "MultiDimensional" }
var dimensionMap = ResourceManager.Current.MainResourceMap.GetSubtree("dimensions");
foreach (var id in resourceIds)
{
NamedResource namedResource;
if (dimensionMap.TryGetValue(id, out namedResource))
{
var resourceCandidates = namedResource.ResolveAll(context);
string candidateInfo = ShowCandidates(id, resourceCandidates);
}
}
Console.WriteLine(candidateInfo);
}
private string ShowCandidates(string resourceId, IReadOnlyList<ResourceCandidate> resourceCandidates)
{
// print 'resourceId', 'found value', 'qualifier info', 'matching condition'
string outText = "resourceId: dimensions\\" + resourceId + "\r\n";
int i = 0;
foreach (var candidate in resourceCandidates)
{
var value = candidate.ValueAsString;
outText += " Candidate " + i.ToString() + ":" + value + "\r\n";
foreach (var qualifier in candidate.Qualifiers)
{
var qualifierName = qualifier.QualifierName;
var qualifierValue = qualifier.QualifierValue;
outText += " Qualifier: " + qualifierName + ": " + qualifierValue + "\r\n";
outText += " Matching: IsMatch (" + qualifier.IsMatch.ToString() + ") " + "IsDefault (" + qualifier.IsDefault.ToString() + ")" + "\r\n";
}
i++;
}
return outText + "\r\n";
}
void SDKTemplate::Scenario10::Scenario10Button_Show_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
Button^ b = safe_cast<Button^>(sender);
if (b != nullptr)
{
// use a cloned context for this scenario so that qualifier values set
// in this scenario don't impact behavior in other scenarios that
// use a default context for the view (crossover effects between
// the scenarios will not be expected)
auto context = ResourceContext::GetForCurrentView()->Clone();
auto selectedLanguage = Scenario10ComboBox_Language->SelectedValue;
auto selectedScale = Scenario10ComboBox_Scale->SelectedValue;
auto selectedContrast = Scenario10ComboBox_Contrast->SelectedValue;
auto selectedHomeRegion = Scenario10ComboBox_HomeRegion->SelectedValue;
if (selectedLanguage != nullptr)
{
context->QualifierValues->Insert("language", selectedLanguage->ToString());
}
if (selectedScale != nullptr)
{
context->QualifierValues->Insert("scale", selectedScale->ToString());
}
if (selectedContrast != nullptr)
{
context->QualifierValues->Insert("contrast", selectedContrast->ToString());
}
if (selectedHomeRegion != nullptr)
{
context->QualifierValues->Insert("homeregion", selectedHomeRegion->ToString());
}
Platform::Collections::Vector<String^>^ resourceIds = ref new Platform::Collections::Vector<String^>();
resourceIds->Append("LanguageOnly");
resourceIds->Append("ScaleOnly");
resourceIds->Append("ContrastOnly");
resourceIds->Append("HomeRegionOnly");
resourceIds->Append("MultiDimensional");
Scenario10_SearchMultipleResourceIds(context, resourceIds);
}
}
void SDKTemplate::Scenario10::Scenario10_SearchMultipleResourceIds(ResourceContext^ context, Platform::Collections::Vector<String^>^ resourceIds)
{
Scenario10TextBlock->Text = "";
auto dimensionMap = ResourceManager::Current->MainResourceMap->GetSubtree("dimensions");
for (unsigned int it = 0; it < resourceIds->Size; it++)
{
String^ id = resourceIds->GetAt(it);
NamedResource^ namedResource = dimensionMap->Lookup(id);
if (namedResource)
{
auto resourceCandidates = namedResource->ResolveAll(context);
Scenario10_ShowCandidates(resourceIds->GetAt(it), resourceCandidates);
}
}
}
void SDKTemplate::Scenario10::Scenario10_ShowCandidates(String^ resourceId, Windows::Foundation::Collections::IVectorView<ResourceCandidate^>^ resourceCandidates)
{
// print 'resourceId', 'found value', 'qualifier info', 'matching condition'
String^ outText = "resourceId: dimensions\\" + resourceId + "\r\n";
for(unsigned int i =0; i < resourceCandidates->Size; i++)
{
ResourceCandidate^ candidate = resourceCandidates->GetAt(i);
auto value = candidate->ValueAsString;
outText += " Candidate " + i.ToString() + ":" + value + "\r\n";
for (unsigned int j = 0; j < candidate->Qualifiers->Size; j++)
{
auto qualifier = candidate->Qualifiers->GetAt(j);
auto qualifierName = qualifier->QualifierName;
auto qualifierValue = qualifier->QualifierValue;
outText += " Qualifier: " + qualifierName + ": " + qualifierValue + "\r\n";
outText += " Matching: IsMatch (" + qualifier->IsMatch.ToString() + ") " + "IsDefault (" + qualifier->IsDefault.ToString() + ")" + "\r\n";
}
}
this->Scenario10TextBlock->Text += outText + "\r\n";
}
Propriétés
AllResourceMaps |
Obtient une carte des objets ResourceMap généralement associés aux packages d’application, indexés par nom de package. |
Current |
Obtient le ResourceManager pour l’application en cours d’exécution. |
DefaultContext |
Obtient le ResourceContext par défaut pour l’application en cours d’exécution. Sauf substitution explicite, le ResourceContext par défaut est utilisé pour déterminer la représentation la plus appropriée d’une ressource nommée donnée. Notes DefaultContext peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt ResourceContext.GetForCurrentView. |
MainResourceMap |
Obtient le ResourceMap associé au package main de l’application en cours d’exécution. |
Méthodes
GetAllNamedResourcesForPackage(String, ResourceLayoutInfo) |
Obtient la liste de toutes les ressources nommées pour un package d’application. |
GetAllSubtreesForPackage(String, ResourceLayoutInfo) |
Obtient la liste de toutes les collections de sous-arborescences de ressources pour un package d’application. |
IsResourceReference(String) |
Détermine si une chaîne fournie correspond au format de référence de ressource (identificateur d’URI de chaîne ms-resource). |
LoadPriFiles(IIterable<IStorageFile>) |
Charge un ou plusieurs fichiers PRI (Package Resource Index) et ajoute leur contenu au gestionnaire de ressources par défaut. |
UnloadPriFiles(IIterable<IStorageFile>) |
Décharge un ou plusieurs fichiers PRI (Package Resource Index). |