ConnectionProfile.GetNetworkUsageAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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
Hinweise
Ein Beispiel für die Verwendung dieser Methoden finden Sie unter Abrufen von Verbindungsnutzungsdaten für einen bestimmten Zeitraum.