ConnectionProfile.GetNetworkUsageAsync Método

Definição

Namespace:

Windows.Networking.Connectivity

Obtém uma lista da duração estimada do tráfego de dados e da conexão durante um período de tempo especificado, para um estado de uso de rede específico.

DataUsageGranularity é usado para indicar a granularidade desejada dos dados retornados e afeta o comprimento da lista retornada. NetworkUsageStates é usado para indicar a configuração de uso de rede desejada.

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))

Parâmetros

startTime

DateTime DateTimeOffset

A hora de início sobre a qual recuperar dados. Não pode ser mais do que 60 dias antes da hora atual. Se a granularidade especificada for PerMinute, a hora de início não poderá ser superior a 120 minutos antes da hora atual.

endTime

DateTime DateTimeOffset

A hora de término sobre a qual recuperar dados. Esse tempo deve ser posterior ao startTime.

granularity

DataUsageGranularity

A granularidade desejada das estatísticas de uso retornadas. Cada elemento na lista corresponde ao uso da rede de acordo com a granularidade especificada; por exemplo, uso por hora.

states

NetworkUsageStates

O estado do perfil de conexão para o qual os dados de uso devem ser retornados.

Retornos

IAsyncOperation<IVectorView<NetworkUsage>>

IAsyncOperation<IReadOnlyList<NetworkUsage>>

Quando o método for concluído, ele retornará uma lista de objetos NetworkUsage , que indicam os valores enviados e recebidos, em bytes, e a quantidade total de tempo em que o perfil foi conectado durante o intervalo de tempo correspondente. As entradas estão em ordem cronológica, começando no startTime. Se o intervalo de tempo não for um múltiplo exato da granularidade, a última entrada relatará o uso somente até o endTime.

Atributos

RemoteAsyncAttribute

Comentários

Para obter um exemplo de como esses métodos são usados, consulte Como recuperar dados de uso de conexão por um período específico de tempo.

Confira também

• DataUsageGranularity
• NetworkUsage
• NetworkUsageStates