Resource​Candidate Resource​Candidate Resource​Candidate Class

Definition

Represents a single possible value for a given NamedResource, the qualifiers associated with that resource, and how well those qualifiers match the context against which it was resolved.

public sealed class ResourceCandidate : IResourceCandidate, IResourceCandidate2public sealed class ResourceCandidate : IResourceCandidate, IResourceCandidate2Public NotInheritable Class ResourceCandidate Implements IResourceCandidate, IResourceCandidate2
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Examples

This example is based on scenario 13 of the Application resources and localization sample. See the sample for the more complete solution.

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

Properties

IsDefault IsDefault IsDefault

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

public PlatForm::Boolean IsDefault { get; }public bool IsDefault { get; }Public ReadOnly Property IsDefault As bool
Value
bool bool bool

TRUE if this candidate can be used as a default fallback value for any context, FALSE otherwise.

Attributes

IsMatch IsMatch IsMatch

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

public PlatForm::Boolean IsMatch { get; }public bool IsMatch { get; }Public ReadOnly Property IsMatch As bool
Value
bool bool bool

TRUE if the ResourceCandidate matched the context, FALSE otherwise.

Attributes

IsMatchAsDefault IsMatchAsDefault IsMatchAsDefault

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

public PlatForm::Boolean IsMatchAsDefault { get; }public bool IsMatchAsDefault { get; }Public ReadOnly Property IsMatchAsDefault As bool
Value
bool bool bool

TRUE if this candidate is an acceptable default fallback value, FALSE otherwise.

Attributes

Qualifiers Qualifiers Qualifiers

Gets the qualifiers associated with this ResourceCandidate.

public IVectorView<ResourceQualifier> Qualifiers { get; }public IVectorView<ResourceQualifier> Qualifiers { get; }Public ReadOnly Property Qualifiers As IVectorView<ResourceQualifier>
Value

The ResourceQualifier s associated with this ResourceCandidate.

Attributes

ValueAsString ValueAsString ValueAsString

Gets the value of this ResourceCandidate, expressed as a string.

public PlatForm::String ValueAsString { get; }public string ValueAsString { get; }Public ReadOnly Property ValueAsString As string
Value
string string string

The string value.

Attributes

Methods

GetQualifierValue(String) GetQualifierValue(String) GetQualifierValue(String)

Returns the value of a qualifier, given its name.

public PlatForm::String GetQualifierValue(String qualifierName)public string GetQualifierValue(String qualifierName)Public Function GetQualifierValue(qualifierName As String) As string
Parameters
qualifierName
System.String System.String System.String

The name of the qualifier.

Returns
string string string

The value of the qualifier.

Attributes

GetValueAsFileAsync() GetValueAsFileAsync() GetValueAsFileAsync()

Asynchronously returns a StorageFile that accesses the value of this ResourceCandidate. This only works on certain types of ResourceCandidate s that are files.

public IAsyncOperation<StorageFile> GetValueAsFileAsync()public IAsyncOperation<StorageFile> GetValueAsFileAsync()Public Function GetValueAsFileAsync() As IAsyncOperation( Of StorageFile )
Returns

An asynchronous operation to return the requested StorageFile.

Attributes

GetValueAsStreamAsync() GetValueAsStreamAsync() GetValueAsStreamAsync()

Asynchronously returns an IRandomAccessStream that accesses the value of this ResourceCandidate.

public IAsyncOperation<IRandomAccessStream> GetValueAsStreamAsync()public IAsyncOperation<IRandomAccessStream> GetValueAsStreamAsync()Public Function GetValueAsStreamAsync() As IAsyncOperation( Of IRandomAccessStream )
Returns

An asynchronous operation to return the requested IRandomAccessStream.

Attributes

See Also