AnalyticsInfo.GetSystemPropertiesAsync(IIterable<String>) Methode

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

Parameter

Gibt zurück

Gibt ein IAsyncOperation-Objekt zurück, das angibt, dass die Aufgabe abgeschlossen wurde und ein IMapView-Objekt mit den angeforderten Attributen als Schlüssel-Wert-Paare enthält.

Attribute

RemoteAsyncAttribute

Windows-Anforderungen

Beispiele

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

Hinweise

Unterstützte Werte für den parameter attributeNames sind potenziell endlos. Es gibt viele Anbieter, die einhaken und beliebige Werte verfügbar machen können. Es gibt eine Handvoll bekannter Attribute, die wahrscheinlich unterstützt werden. In den meisten Fällen wird die Groß-/Kleinschreibung beachtet:

• App
• AppVer
• DeviceFamily
• FlightRing
• OSVersionFull

Die Absicht dieser Methode besteht darin, diese Informationen nur für Analysen zu verwenden und sich nicht auf einen bestimmten Wert auf dem Client zu verlassen. Die Unterstützung für diese Werte ändert sich im Laufe der Zeit.

Gilt für: