ResourceCandidate クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.Resources.Core

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

特定の NamedResource、そのリソースに関連付けられている修飾子、およびそれらの修飾子が解決されたコンテキストとどの程度一致するかについて、1 つの可能な値を表します。

public ref class ResourceCandidate sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ResourceCandidate final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ResourceCandidate

Public NotInheritable Class ResourceCandidate

継承: Object Platform::Object IInspectable ResourceCandidate

属性: ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

この例は、アプリケーションリソースとローカライズサンプルのシナリオ 10 に基づいています。完全なソリューションについては、サンプルを参照してください。

private void Scenario10Button_Show_Click(object sender, RoutedEventArgs e)
{
    Button b = sender as Button;
    if (b != null)
    {
        // Use a cloned context for this scenario so that qualifier values set
        // in this scenario don't impact behavior in other scenarios that
        // use a default context for the view (crossover effects between
        // the scenarios will not be expected).
        var context = ResourceContext.GetForCurrentView().Clone();

        var selectedLanguage = Scenario10ComboBox_Language.SelectedValue;
        var selectedScale = Scenario10ComboBox_Scale.SelectedValue;
        var selectedContrast = Scenario10ComboBox_Contrast.SelectedValue;
        var selectedHomeRegion = Scenario10ComboBox_HomeRegion.SelectedValue;

        if (selectedLanguage != null)
        {
            context.QualifierValues["language"] = selectedLanguage.ToString();
        }
        if (selectedScale != null)
        {
            context.QualifierValues["scale"] = selectedScale.ToString();
        }
        if (selectedContrast != null)
        {
            context.QualifierValues["contrast"] = selectedContrast.ToString();
        }
        if (selectedHomeRegion != null)
        {
            context.QualifierValues["homeregion"] = selectedHomeRegion.ToString();
        }
        Scenario10_SearchMultipleResourceIds(context, new string[] { "LanguageOnly", "ScaleOnly", "ContrastOnly", "HomeRegionOnly", "MultiDimensional" });
    }
}

void Scenario10_SearchMultipleResourceIds(ResourceContext context, string[] resourceIds)
{
    this.Scenario10TextBlock.Text = "";
    var dimensionMap = ResourceManager.Current.MainResourceMap.GetSubtree("dimensions");

    foreach (var id in resourceIds)
    {
        NamedResource namedResource;
        if (dimensionMap.TryGetValue(id, out namedResource))
        {
            var resourceCandidates = namedResource.ResolveAll(context);
            Scenario10_ShowCandidates(id, resourceCandidates);
        }
    }
}

void Scenario10_ShowCandidates(string resourceId, IReadOnlyList<ResourceCandidate> resourceCandidates)
{
    // Print 'resourceId', 'found value', 'qualifer info', 'matching condition'
    string outText = "resourceId: dimensions\\" + resourceId + "\r\n";
    int i = 0;
    foreach (var candidate in resourceCandidates)
    {
        var value = candidate.ValueAsString;
        outText += "    Candidate " + i.ToString() + ":" + value + "\r\n";
        int j = 0;
        foreach (var qualifier in candidate.Qualifiers)
        {
            var qualifierName = qualifier.QualifierName;
            var qualifierValue = qualifier.QualifierValue;
            outText += "        Qualifer: " + qualifierName + ": " + qualifierValue + "\r\n";
            outText += "        Matching: IsMatch (" + qualifier.IsMatch.ToString() + ")  " + "IsDefault (" + qualifier.IsDefault.ToString() + ")" + "\r\n";
            j++;
        }
        i++;
    }

    this.Scenario10TextBlock.Text += outText + "\r\n";
}

注釈

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1903	18362	種類

プロパティ

IsDefault	この ResourceCandidate を任意のコンテキストの既定のフォールバック値として使用できるかどうかを示します。
IsMatch	この ResourceCandidate が、評価対象の ResourceContext と一致したかどうかを示します。
IsMatchAsDefault	この ResourceCandidate が、真の一致、既定のフォールバック値、または既定のフォールバックとの混合一致 (つまり、一部の修飾子に関連するが、他の修飾子に既定のフォールバック値を使用する) の結果として評価された ResourceContext と一致したかどうかを示します。
Kind	この ResourceCandidate にカプセル化されているリソースの種類を取得します。
Qualifiers	この ResourceCandidate に関連付けられている修飾子を取得します。
ValueAsString	文字列として表されるこの ResourceCandidate の値を取得します。

メソッド

GetQualifierValue(String)	修飾子の名前を指定して、値を返します。
GetValueAsFileAsync()	この ResourceCandidate の値にアクセスする StorageFile を非同期的に返します。これは、ファイルである特定の種類の ResourceCandidateでのみ機能します。
GetValueAsStreamAsync()	この ResourceCandidate の値にアクセスする IRandomAccessStream を非同期的に返します。

適用対象

こちらもご覧ください

アプリリソースとローカライズのサンプル

次の方法で共有