AnalyticsInfo.GetSystemPropertiesAsync(IIterable<String>) Método

Definição

Namespace:

Windows.System.Profile

Recupera de forma assíncrona os atributos do sistema solicitados.

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))

Parâmetros

attributeNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Uma lista IIterable de cadeias de caracteres que contêm os atributos do sistema a serem recuperados.

Retornos

IAsyncOperation<IMapView<String,String>>

IAsyncOperation<IReadOnlyDictionary<String,String>>

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

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

Retorna um objeto IAsyncOperation indicando que a tarefa foi concluída e que contém um objeto IMapView com os atributos solicitados como pares Chave/Valor.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Exemplos

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

Comentários

Os valores com suporte para o parâmetro attributeNames são potencialmente infinitos. Há muitos provedores que se conectam e podem expor valores arbitrários. Há alguns atributos conhecidos que provavelmente serão suportados. Na maioria dos casos, eles diferenciam maiúsculas de minúsculas:

• Aplicativo
• AppVer
• DeviceFamily
• FlightRing
• OSVersionFull

A intenção desse método é usar essas informações apenas para análise e não depender de um valor específico no cliente. O suporte para esses valores será alterado ao longo do tempo.