ConnectionProfile.GetNetworkUsageAsync Methode

  • Referenz

Definition

Namespace:
Windows.Networking.Connectivity
Bearbeiten

Ruft eine Liste des geschätzten Datenverkehrs und der Verbindungsdauer für einen bestimmten Zeitraum für einen bestimmten Netzwerknutzungszustand ab.

DataUsageGranularity wird verwendet, um die gewünschte Granularität der zurückgegebenen Daten anzugeben und wirkt sich auf die Länge der zurückgegebenen Liste aus. NetworkUsageStates wird verwendet, um die gewünschte Netzwerknutzungskonfiguration anzugeben.

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

Parameter

startTime
DateTime DateTimeOffset

Die Startzeit, über die Daten abgerufen werden sollen. Darf nicht mehr als 60 Tage vor der aktuellen Zeit sein. Wenn die angegebene Granularität PerMinute ist, darf die Startzeit nicht mehr als 120 Minuten vor der aktuellen Zeit betragen.

endTime
DateTime DateTimeOffset

Die Endzeit, über die Daten abgerufen werden sollen. Dieser Zeitpunkt muss später als die startTime sein.

granularity
DataUsageGranularity

Die gewünschte Granularität der zurückgegebenen Nutzungsstatistiken. Jedes Element in der Liste entspricht der Netzwerknutzung gemäß der angegebenen Granularität. z. B. Nutzung pro Stunde.

states
NetworkUsageStates

Der Zustand des Verbindungsprofils, für das Nutzungsdaten zurückgegeben werden sollen.

Gibt zurück

IAsyncOperation<IVectorView<NetworkUsage>>

IAsyncOperation<IReadOnlyList<NetworkUsage>>

Wenn die Methode abgeschlossen ist, gibt sie eine Liste von NetworkUsage-Objekten zurück, die die gesendeten und empfangenen Werte in Bytes und die Gesamtdauer der Verbindung des Profils während des entsprechenden Zeitintervalls angeben. Die Einträge sind in chronologischer Reihenfolge ab startTime. Wenn die Zeitspanne kein exaktes Vielfaches der Granularität ist, meldet der letzte Eintrag die Nutzung nur bis endTime.

Attribute
RemoteAsyncAttribute

Hinweise

Ein Beispiel für die Verwendung dieser Methoden finden Sie unter Abrufen von Verbindungsnutzungsdaten für einen bestimmten Zeitraum.

Gilt für:

Weitere Informationen