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

返される使用状況統計の目的の粒度。 リスト内の各要素は、指定された粒度ごとのネットワーク使用量に対応します。たとえば、1 時間あたりの使用量などです。

states
NetworkUsageStates

使用状況データを返す必要がある接続プロファイルの状態。

戻り値

IAsyncOperation<IVectorView<NetworkUsage>>

IAsyncOperation<IReadOnlyList<NetworkUsage>>

メソッドが完了すると、 NetworkUsage オブジェクトの一覧が返されます。これは、送信値と受信値をバイト単位で示し、対応する時間間隔中にプロファイルが接続された合計時間を示します。 エントリは、startTime から順に時系列に並べられます。 期間が粒度の正確な倍数でない場合、最後のエントリは endTime までの使用状況のみを報告します。

属性
RemoteAsyncAttribute

注釈

これらのメソッドの使用方法の例については、「特定の期間の 接続使用状況データを取得する方法」を参照してください。

適用対象

こちらもご覧ください