AnalyticsInfo.GetSystemPropertiesAsync(IIterable<String>) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.System.Profile

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Recupera in modo asincrono gli attributi di sistema richiesti.

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

Parametri

attributeNames: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Elenco IIterable di stringhe contenenti gli attributi di sistema da recuperare.

Restituisce

IAsyncOperation<IMapView<String,String>>

IAsyncOperation<IReadOnlyDictionary<String,String>>

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

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

Restituisce un oggetto IAsyncOperation che indica che l'attività è stata completata e contenente un oggetto IMapView con gli attributi richiesti come coppie Chiave/Valore.

Attributi: RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Esempio

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

Commenti

I valori supportati per il parametro attributeNames sono potenzialmente infiniti. Esistono molti provider che si associano e possono esporre valori arbitrari. È probabile che siano supportati alcuni attributi noti. Nella maggior parte dei casi viene fatta distinzione tra maiuscole e minuscole:

App
AppVer
DeviceFamily
FlightRing
OSVersionFull

L'intenzione di questo metodo è usare queste informazioni solo per l'analisi e non basarsi su un valore specifico sul client. Il supporto per questi valori cambierà nel tempo.

Si applica a

Condividi tramite