ConnectionProfile.GetNetworkUsageAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取特定网络使用状态在指定时间段内估计的数据流量和连接持续时间的列表。
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
应为其返回使用情况数据的连接配置文件的状态。
返回
方法完成后,它将返回 NetworkUsage 对象的列表,该列表指示发送和接收的值(以字节为单位),以及配置文件在相应时间间隔内连接的总时间量。 条目按时间顺序排列,从 startTime 开始。 如果时间跨度不是粒度的确切倍数,则最后一个条目将仅报告到 endTime 的使用情况。
- 属性
注解
有关如何使用这些方法的示例,请参阅 如何检索特定时间段的连接使用情况数据。