ResourceCandidate Class

Representa un único valor posible para un objeto NamedResource determinado, los calificadores asociados a ese recurso, y cómo coinciden esos calificadores con el contexto en el que se resolvió.

Sintaxis


var resourceCandidate = resourceMap.getValue(string, resourceContext);
var resourceCandidate = namedResource.resolve(resourceContext);
var resourceCandidate = resourceCandidateVectorView.getAt(uInt32);

Atributos

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

Members

A continuación se indican los tipos de miembros de ResourceCandidate (Clase):

Métodos

The ResourceCandidate Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
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.

 

Propiedades

ResourceCandidateClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

IsDefault

De sólo lecturaIndicates whether this ResourceCandidate can be used as a default fallback value for any context.

IsMatch

De sólo lecturaIndicates whether this ResourceCandidate matched the ResourceContext against which it was evaluated.

IsMatchAsDefault

De sólo lecturaIndicates 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

De sólo lecturaGets the qualifiers associated with this ResourceCandidate.

ValueAsString

De sólo lecturaGets the value of this ResourceCandidate, expressed as a string.

 

Ejemplos

Este ejemplo se basa en el escenario 13 de Ejemplo de recursos y localización de la aplicación. Vea el ejemplo para una solución más completa.


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

Requisitos

Cliente mínimo admitido

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

Ejemplo de recursos y localización de la aplicación

 

 

Mostrar:
© 2014 Microsoft