ConnectionProfile.GetNetworkUsageAsync 方法

定義

命名空間:

Windows.Networking.Connectivity

針對特定網路使用量狀態，取得指定時段內估計的資料流量和連線持續時間清單。

DataUsageGranularity 可用來指出所傳回資料所需的資料細微性，並影響傳回清單的長度。 NetworkUsageStates 可用來指出所需的網路使用量設定。

public:
 virtual IAsyncOperation<IVectorView<NetworkUsage ^> ^> ^ GetNetworkUsageAsync(DateTime startTime, DateTime endTime, DataUsageGranularity granularity, NetworkUsageStates states) = GetNetworkUsageAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<NetworkUsage>> GetNetworkUsageAsync(DateTime const& startTime, DateTime const& endTime, DataUsageGranularity const& granularity, NetworkUsageStates const& states);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<NetworkUsage>> GetNetworkUsageAsync(System.DateTimeOffset startTime, System.DateTimeOffset endTime, DataUsageGranularity granularity, NetworkUsageStates states);

function getNetworkUsageAsync(startTime, endTime, granularity, states)

Public Function GetNetworkUsageAsync (startTime As DateTimeOffset, endTime As DateTimeOffset, granularity As DataUsageGranularity, states As NetworkUsageStates) As IAsyncOperation(Of IReadOnlyList(Of NetworkUsage))

參數

startTime

DateTime DateTimeOffset

要擷取資料的開始時間。 在目前時間之前不能超過 60 天。 如果指定的 資料細微性 是 PerMinute，則開始時間在目前時間之前不能超過 120 分鐘。

endTime

DateTime DateTimeOffset

要擷取資料的結束時間。 這次必須晚于 startTime。

granularity

DataUsageGranularity

所傳回使用量統計資料所需的細微性。 清單中的每個元素都會對應至每個指定細微性的網路使用量;例如，每小時使用量。

states

NetworkUsageStates

應該傳回使用量資料的連線設定檔狀態。

傳回

IAsyncOperation<IVectorView<NetworkUsage>>

IAsyncOperation<IReadOnlyList<NetworkUsage>>

當方法完成時，它會傳回 NetworkUsage 物件清單，指出傳送和接收的值，以位元組為單位，以及設定檔在對應時間間隔內連接的總時間量。 專案依時間順序排列，從 startTime 開始。 如果時間範圍不是資料細微性的確切倍數，則最後一個專案只會報告 endTime 的使用方式。

屬性

RemoteAsyncAttribute

備註

如需如何使用這些方法的範例，請參閱 如何擷取特定時段的連線使用方式資料。

另請參閱

• DataUsageGranularity
• NetworkUsage
• NetworkUsageStates