ResourceManager class (Windows)

2 out of 5 rated this helpful - Rate this topic

Provides access to application resource maps and more advanced resource functionality.

Syntax


var resourceManager = Windows.ApplicationModel.Resources.Core.ResourceManager;

Attributes

MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.ApplicationModel.Resources.Core.IResourceManagerStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)

Members

The ResourceManager class has these types of members:

Methods
Properties

Methods

The ResourceManager class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Method	Description
IsResourceReference	Determines whether a supplied string matches the resource reference format (an ms-resource string URI identifier).
LoadPriFiles	Loads one or more PRI files and adds their contents to the default resource manager.
UnloadPriFiles	Unloads one or more PRI files.

Properties

The ResourceManager class has these properties.

Property	Access type	Description
AllResourceMaps	Read-only	Gets a map of ResourceMap objects typically associated with the app packages, indexed by package name.
Current	Read-only	Gets the ResourceManager for the currently running application.
DefaultContext	Read-only	Gets the default ResourceContext for the currently running application. Unless explicitly overridden, the default ResourceContext is used to determine the most appropriate representation of any given named resource.
MainResourceMap	Read-only	Gets the ResourceMap that is associated with the main package of the currently running application.

Examples

This example is based on scenario 13 of the Application resources and localization sample. See the sample for the more complete solution.

JavaScript


// Create a ResourceContext.
var resourceContext = new Windows.ApplicationModel.Resources.Core.ResourceContext();

// Set the specific context for lookup of resources.
var qualifierValues = resourceContext.qualifierValues;
qualifierValues["language"] = "en-US";
qualifierValues["contrast"] = "standard";
qualifierValues["scale"] = "140";
qualifierValues["homeregion"] = "021"; // Northern America

// Resources actually reside within Scenario13 Resource Map.
var resourceIds = [
    '/Scenario13/languageOnly',
    '/Scenario13/scaleOnly',
    '/Scenario13/contrastOnly',
    '/Scenario13/homeregionOnly',
    '/Scenario13/multiDimensional',
];

var output = { str: "" };
resourceIds.forEach(function (resourceId) {
    renderNamedResource(resourceId, resourceContext, output);
});

function renderNamedResource(resourceId, resourceContext, output) {
    output.str += "Resource ID " + resourceId + ":\n";
    // Lookup the resource in the mainResourceMap (the one for this package).
    var namedResource = Windows.ApplicationModel.Resources.Core.ResourceManager.current.mainResourceMap.lookup(resourceId);

    // Return a ResourceCandidateVectorView of all possible resources candidates
    // resolved against the context in order of appropriateness.
    var resourceCandidates = namedResource.resolveAll(resourceContext);

    resourceCandidates.forEach(function (candidate, index) {
        renderCandidate(candidate, index, output);
    });
    output.str += "\n";
}

function renderCandidate(candidate, index, output) {
    // Get all the various qualifiers for the candidate (such as language, scale, contrast).
    candidate.qualifiers.forEach(function (qualifier) {
        output.str += "qualifierName: " + qualifier.qualifierName + "\n";
        output.str += "qualifierValue: " + qualifier.qualifierValue + "\n";
        output.str += "isDefault: ";
        output.str += (qualifier.isDefault) ? "true\n" : "false\n";
        output.str += "isMatch: ";
        output.str += (qualifier.isMatch) ? "true\n" : "false\n";
        output.str += "score: " + qualifier.score + "\n";
        output.str += "\n";
    });
}

Requirements

Minimum supported client	Windows 8 [Windows Store apps only]
Minimum supported server	Windows Server 2012 [Windows Store apps only]
Namespace	Windows.ApplicationModel.Resources.Core Windows::ApplicationModel::Resources::Core [C++]
Metadata	Windows.winmd

ResourceManager class