ResourceCandidate Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет одно возможное значение для заданного NamedResource, квалификаторов, связанных с этим ресурсом, и насколько хорошо эти квалификаторы соответствуют контексту, в котором они были разрешены.
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
- Наследование
- Атрибуты
Требования к 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 | Kind |
Свойства
IsDefault |
Указывает, можно ли использовать этот ResourceCandidate в качестве резервного значения по умолчанию для любого контекста. |
IsMatch |
Указывает, совпадает ли этот параметр ResourceCandidate с resourceContext , по которому он был оценен. |
IsMatchAsDefault |
Указывает, совпадает ли этот параметр ResourceCandidate с ResourceContext , по которому он был оценен в результате истинного соответствия, резервного значения по умолчанию или смешанного соответствия с резервным значением по умолчанию (то есть соответствие по отношению к некоторым квалификаторам, но использование резервных значений по умолчанию для других квалификаторов). |
Kind |
Возвращает тип ресурса, инкапсулированного в этом ResourceCandidate. |
Qualifiers |
Возвращает квалификаторы, связанные с данным ResourceCandidate. |
ValueAsString |
Возвращает значение resourceCandidate, выраженное в виде строки. |
Методы
GetQualifierValue(String) |
Возвращает значение квалификатора с заданным его именем. |
GetValueAsFileAsync() |
Асинхронно возвращает объект StorageFile , который обращается к значению этого resourceCandidate. Это работает только с определенными типами объектов ResourceCandidate, которые являются файлами. |
GetValueAsStreamAsync() |
Асинхронно возвращает IRandomAccessStream , который обращается к значению этого resourceCandidate. |