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. Если интервал времени не является точным кратным степени детализации, то последняя запись будет сообщать об использовании только до конца времени.

Атрибуты

Комментарии

Пример использования этих методов см. в статье Получение данных об использовании подключений за определенный период времени.

Применяется к

См. также раздел