Skip to main content
ResourceManager class

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


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

public sealed class ResourceManager

Public NotInheritable Class ResourceManager

public ref class ResourceManager sealed 


The ResourceManager class has these types of members:


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

GetAllNamedResourcesForPackage Gets a list of all named resources for an app package.
GetAllSubtreesForPackage Gets a list of all collections of resource subtrees for an app package.
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.



The ResourceManager class has these properties.

PropertyAccess typeDescription


Read-onlyGets a map of ResourceMap objects typically associated with the app packages, indexed by package name.


Read-onlyGets the ResourceManager for the currently running application.


Read-onlyGets 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.


Read-onlyGets the ResourceMap that is associated with the main package of the currently running application.



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

// 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 = [

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 (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0


Windows::ApplicationModel::Resources::Core [C++]



Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]


Windows::ApplicationModel::Resources::Core [C++]




[ MarshalingBehavior(Agile)]
[ Threading(Both)]
[ Version(0x06020000)]

See also

Creating and retrieving resources in Windows Store apps
App resources and localization sample