AnalyticsInfo.GetSystemPropertiesAsync(IIterable<String>) Метод

Ссылка

Определение

Пространство имен:: Windows.System.Profile

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Асинхронно извлекает запрошенные системные атрибуты.

public:
 static IAsyncOperation<IMapView<Platform::String ^, Platform::String ^> ^> ^ GetSystemPropertiesAsync(IIterable<Platform::String ^> ^ attributeNames);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IMapView<winrt::hstring, winrt::hstring const&>> GetSystemPropertiesAsync(IIterable<winrt::hstring> const& attributeNames);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyDictionary<string,string>> GetSystemPropertiesAsync(IEnumerable<string> attributeNames);

function getSystemPropertiesAsync(attributeNames)

Public Shared Function GetSystemPropertiesAsync (attributeNames As IEnumerable(Of String)) As IAsyncOperation(Of IReadOnlyDictionary(Of String, String))

Параметры

attributeNames: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

IIterable список строк, содержащих системные атрибуты для извлечения.

Возвращаемое значение

IAsyncOperation<IMapView<String,String>>

IAsyncOperation<IReadOnlyDictionary<String,String>>

IAsyncOperation<IMapView<Platform::String,Platform::String>>

IAsyncOperation<IMapView<winrt::hstring,winrt::hstring>>

Возвращает объект IAsyncOperation , указывающий, что задача завершена и содержит объект IMapView с запрошенными атрибутами в виде пар "ключ-значение".

Атрибуты: RemoteAsyncAttribute

Требования к Windows

Семейство устройств	Windows 10, version 1803 (появилось в 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v6.0)

Примеры

using Windows.System.Profile;

// ...

var attrNames = new List<string>({"DeviceFamily", "OSVersionFull", "FlightRing"});
var attrData = AnalyticsInfo.GetSystemPropertiesAsync(attrNames).AsTask().GetAwaiter().GetResult();

// The map can be serialized and sent to a backend service for analytics or targeting 
foreach (KeyValuePair<string, string> attr in attrData) 
{ 
    Console.WriteLine($"{attr.Key}={attr.Value}");
}

Поддерживаемые значения для параметра attributeNames могут быть бесконечными. Существует множество поставщиков, которые перехватываются и могут предоставлять произвольные значения. Существует несколько известных атрибутов, которые, скорее всего, будут поддерживаться. В большинстве случаев регистр учитывается:

Приложение
AppVer
DeviceFamily
FlightRing
OSVersionFull

Цель этого метода заключается в том, чтобы использовать эти сведения только для аналитики и не полагаться на определенное значение на клиенте. Поддержка этих значений будет меняться со временем.

Применяется к

Поделиться через