AnalyticsInfo.GetSystemPropertiesAsync(IIterable<String>) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera asincrónicamente los atributos del 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
Lista IIterable de cadenas que contienen los atributos del sistema que se van a recuperar.
Devoluciones
IAsyncOperation<IMapView<Platform::String,Platform::String>>
IAsyncOperation<IMapView<winrt::hstring,winrt::hstring>>
Devuelve un objeto IAsyncOperation que indica que la tarea se ha completado y que contiene un objeto IMapView con los atributos solicitados como pares clave-valor.
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)
|
Ejemplos
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}");
}
Comentarios
Los valores admitidos para el parámetro attributeNames son potencialmente interminables . Hay muchos proveedores que se enlazan y pueden exponer valores arbitrarios. Hay una serie de atributos conocidos que es probable que se admita. En la mayoría de los casos, distingue entre mayúsculas y minúsculas:
- Aplicación
- AppVer
- DeviceFamily
- FlightRing
- OSVersionFull
La intención de este método es usar esta información solo para el análisis y no confiar en un valor determinado en el cliente. La compatibilidad con estos valores cambiará con el tiempo.