ResourceCandidate Class

Представляет одно возможное значение для данного ресурса NamedResource, квалификаторы, связанные с этим ресурсом, и то, насколько квалификаторы соответствуют контексту, с которым он был разрешен.

Синтаксис


public sealed class ResourceCandidate

Атрибуты

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

Члены

ResourceCandidateКласс имеет следующие типы членов:

Методы

The ResourceCandidate Класс имеет следующие методы. В C#, Visual Basic и C++ также наследует методы от Object Класс.

МетодОписание
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.

 

Свойства

ResourceCandidateКласс имеет следующие свойства.

СвойствоТип доступаОписание

IsDefault

Только для чтенияIndicates whether this ResourceCandidate can be used as a default fallback value for any context.

IsMatch

Только для чтенияIndicates whether this ResourceCandidate matched the ResourceContext against which it was evaluated.

IsMatchAsDefault

Только для чтенияIndicates 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

Только для чтенияGets the qualifiers associated with this ResourceCandidate.

ValueAsString

Только для чтенияGets the value of this ResourceCandidate, expressed as a string.

 

Примеры

Этот пример основан на сценарии 13 из раздела Ресурсы приложения и пример локализации. См. пример более полного решения.


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

Требования

Минимальный поддерживаемый клиент

Windows 8 [Только приложения для Магазина Windows]

Минимальный поддерживаемый сервер

Windows Server 2012 [Только приложения для Магазина Windows]

Пространство имен

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

Metadata

Windows.winmd

См. также

Ресурсы приложения и пример локализации

 

 

Показ:
© 2014 Microsoft