ResourceCandidate Class

Représente une valeur possible unique pour une NamedResource donnée, les qualificateurs associés à cette ressource, et à quel point ces qualificateurs sont conformes au contexte avec lequel ils ont été résolus.

Syntaxe


public ref class ResourceCandidate sealed 

Attributs

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

Membres

ResourceCandidateClasse possède ces types de membres :

Méthodes

The ResourceCandidate Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
GetQualifierValue Returns the value of a qualifier, given its name.
GetValueAsFileAsync Asynchronously returns a StorageFile that accesses the value of this ResourceCandidate. This only works on certain types of ResourceCandidates that are files.

 

Propriétés

Le ResourceCandidateClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

IsDefault

En lecture seuleIndicates whether this ResourceCandidate can be used as a default fallback value for any context.

IsMatch

En lecture seuleIndicates whether this ResourceCandidate matched the ResourceContext against which it was evaluated.

IsMatchAsDefault

En lecture seuleIndicates whether this ResourceCandidate matched the ResourceContext against which it was evaluated as a result of being a default fallback value or mixed match with default fallback (that is, a match in relation to some qualifiers but using default fallback values for other qualifiers), and not as a true match.

Qualifiers

En lecture seuleGets the qualifiers associated with this ResourceCandidate.

ValueAsString

En lecture seuleGets the value of this ResourceCandidate, expressed as a string.

 

Exemples

Cet exemple est basé sur le scénario 13 de l'Exemple de ressources et de localisation d'application. Pour obtenir la solution complète, consultez l'exemple.


// 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";
    });
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

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

Métadonnées

Windows.winmd

Voir aussi

Exemple de ressources et de localisation d'application

 

 

Afficher:
© 2014 Microsoft