ConnectionProfile.GetNetworkUsageAsync Méthode

  • Référence

Définition

Espace de noms:
Windows.Networking.Connectivity
Modifier

Obtient la liste des estimations du trafic de données et de la durée de connexion sur une période spécifiée, pour un état d’utilisation du réseau spécifique.

DataUsageGranularity est utilisé pour indiquer la granularité souhaitée des données retournées et affecte la longueur de la liste retournée. NetworkUsageStates est utilisé pour indiquer la configuration d’utilisation réseau souhaitée.

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

Paramètres

startTime
DateTime DateTimeOffset

Heure de début au cours de laquelle récupérer des données. Ne peut pas être plus de 60 jours avant l’heure actuelle. Si la granularité spécifiée est PerMinute, l’heure de début ne peut pas être supérieure à 120 minutes avant l’heure actuelle.

endTime
DateTime DateTimeOffset

Heure de fin pendant laquelle récupérer des données. Cette heure doit être postérieure à startTime.

granularity
DataUsageGranularity

Granularité souhaitée des statistiques d’utilisation retournées. Chaque élément de la liste correspond à l’utilisation du réseau selon la granularité spécifiée ; par exemple, l’utilisation par heure.

states
NetworkUsageStates

État du profil de connexion pour lequel les données d’utilisation doivent être retournées.

Retours

IAsyncOperation<IVectorView<NetworkUsage>>

IAsyncOperation<IReadOnlyList<NetworkUsage>>

Une fois la méthode terminée, elle retourne une liste d’objets NetworkUsage , qui indiquent les valeurs envoyées et reçues, en octets, et la durée totale pendant laquelle le profil a été connecté pendant l’intervalle de temps correspondant. Les entrées sont dans l’ordre chronologique, en commençant à startTime. Si l’intervalle de temps n’est pas un multiple exact de la granularité, la dernière entrée signale l’utilisation uniquement jusqu’à endTime.

Attributs
RemoteAsyncAttribute

Remarques

Pour obtenir un exemple d’utilisation de ces méthodes, consultez Comment récupérer des données d’utilisation de connexion pour une période spécifique.

S’applique à

Voir aussi