ResourceCandidate Class

Rappresenta un singolo valore consentito per una risorsa NamedResource specificata, i qualificatori associati a tale risorsa e il livello di corrispondenza tra tali qualificatori e il contesto di risoluzione.

Sintassi


public sealed class ResourceCandidate

Attributi

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

Membri

ResourceCandidateClasse include questi tipi di membri:

Metodi

The ResourceCandidate Classe dispone di tali metodi. In C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
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.

 

Proprietà

Classe dispone di tali proprietà. di ResourceCandidate

ProprietàTipo di accessoDescrizione

IsDefault

Sola letturaIndicates whether this ResourceCandidate can be used as a default fallback value for any context.

IsMatch

Sola letturaIndicates whether this ResourceCandidate matched the ResourceContext against which it was evaluated.

IsMatchAsDefault

Sola letturaIndicates 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

Sola letturaGets the qualifiers associated with this ResourceCandidate.

ValueAsString

Sola letturaGets the value of this ResourceCandidate, expressed as a string.

 

Esempi

Questo esempio è basato sullo scenario 13 dell'Esempio di risorse e di localizzazione dell'applicazione. Per la soluzione completa, vedere l'esempio.


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

Requisiti

Client supportato minimo

Windows 8 [Solo applicazioni Windows Store]

Server supportato minimo

Windows Server 2012 [Solo applicazioni Windows Store]

Spazio dei nomi

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

Metadati

Windows.winmd

Vedere anche

Esempio di risorse e di localizzazione dell'applicazione

 

 

Mostra:
© 2014 Microsoft