ResourceCandidate Class

Stellt einen einzelnen möglichen Wert für eine angegebene NamedResource dar, sowie für die der Ressource zugeordneten Qualifizierer und den Grad der Übereinstimmung dieser Qualifizierer mit dem Kontext, für den sie aufgelöst wurde.

Syntax


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

Attribute

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

Member

ResourceCandidateKlasse hat diese Membertypen:

Methoden

The ResourceCandidate Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

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

 

Eigenschaften

Der ResourceCandidateKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

IsDefault

SchreibgeschütztIndicates whether this ResourceCandidate can be used as a default fallback value for any context.

IsMatch

SchreibgeschütztIndicates whether this ResourceCandidate matched the ResourceContext against which it was evaluated.

IsMatchAsDefault

SchreibgeschütztIndicates 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

SchreibgeschütztGets the qualifiers associated with this ResourceCandidate.

ValueAsString

SchreibgeschütztGets the value of this ResourceCandidate, expressed as a string.

 

Beispiele

Dieses Beispiel basiert auf Szenario 13 des Beispiels für Anwendungsressourcen und Lokalisierung. Die umfangreichere Lösung finden Sie im Beispiel.


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

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

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

Metadaten

Windows.winmd

Siehe auch

Anwendungsressourcen- und Lokalisierungsbeispiel

 

 

Anzeigen:
© 2014 Microsoft