ConnectionProfile.GetNetworkUsageAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает список предполагаемого трафика данных и продолжительности подключения за указанный период времени для определенного состояния использования сети.
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. Если интервал времени не является точным кратным степени детализации, то последняя запись будет сообщать об использовании только до конца времени.
- Атрибуты
Комментарии
Пример использования этих методов см. в статье Получение данных об использовании подключений за определенный период времени.