AnalyticsInfo.GetSystemPropertiesAsync(IIterable<String>) Metode

Definisi

Ruang nama:

Windows.System.Profile

Secara asinkron mengambil atribut sistem yang diminta.

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

attributeNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Daftar string yang dapat diubah yang berisi atribut sistem untuk diambil.

Mengembalikan

IAsyncOperation<IMapView<String,String>>

IAsyncOperation<IReadOnlyDictionary<String,String>>

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

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

Mengembalikan objek IAsyncOperation yang menunjukkan bahwa tugas telah selesai dan berisi objek IMapView dengan atribut yang diminta sebagai pasangan Kunci/Nilai.

Atribut

RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)

Contoh

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

Keterangan

Nilai yang didukung untuk parameter attributeNames berpotensi tidak ada habisnya. Ada banyak penyedia yang menghubungkan dan dapat mengekspos nilai arbitrer. Ada beberapa atribut yang diketahui yang kemungkinan akan didukung. Dalam kebanyakan kasus, ini peka huruf besar/kecil:

• Aplikasi
• AppVer
• DeviceFamily
• FlightRing
• OSVersionFull

Tujuan dari metode ini adalah untuk menggunakan informasi ini hanya untuk analitik dan tidak bergantung pada nilai tertentu pada klien. Dukungan untuk nilai-nilai ini akan berubah dari waktu ke waktu.