So wird’s gemacht: Abrufen von Netzwerkverbindungsnutzungsdaten (HTML)

Artikel
12/12/2015

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

In diesem Thema wird erläutert, wie Sie mit Klassen im Windows.Networking.Connectivity-Namespace auf Informationen zur Bandbreitenverwendung einer Netzwerkverbindung für einen bestimmten Zeitraum zugreifen.

Allgemeine Informationen zum Abrufen von Verbindungsprofilen und Zugreifen auf Informationen zur Verwendung dieser Objekte finden Sie unter So wird's gemacht: Abrufen von Netzwerkverbindungsinformationen.

Wissenswertes

Technologien

Windows.Networking.Connectivity

Voraussetzungen

Das folgende Beispiel verwendet JavaScript und basiert auf dem Netzwerkinformationsbeispiel. Allgemeine Informationen zum Erstellen einer Windows-Runtime-App mit JavaScript finden Sie unter Erstellen Ihrer ersten Windows-Runtime-App mit JavaScript.

Abrufen von Daten zu Internetverbindungskosten für die letzte Stunde

Die folgende Beispielfunktion ruft zuerst das ConnectionProfile für die Internetverbindung ab. Zum Abrufen der benötigten Daten werden die System-DateTime (currTime) und ein startTime-Wert an die getNetworkUsageAsync-Methode übergeben. Es wird ein NetworkUsage-Objekt zurückgegeben, das die Werte für die gesendeten und empfangenen Bytes für den angeforderten Zeitraum enthält.

Bei Szenarien mit mobilen Apps können Sie dem getNetworkUsageAsync-Aufruf einen RoamingStates-Wert hinzufügen, um die angeforderten Datenverkehrsdaten auf Zeiträume zu begrenzen, in denen Roaming erfolgt ist.

    var networkInfo = Windows.Networking.Connectivity.NetworkInformation;

    function DisplayLocalDataUsage() {
        var currTime = new Date();

        //Set start Time to 1 hour (3600000ms) before current time
        var startTime = new Date(currTime - 3600000);

        //Get the ConnectionProfile that is currently used to connect to the Internet
        var connectionProfile = networkInfo.getInternetConnectionProfile();
        var LocalUsage = connectionProfile.getNetworkUsageAsync(startTime, currTime);
        var lclString = "Local Data Usage: \n\r";
        lclString += "Bytes Sent: " + LocalUsage.bytesSent + "\n\r";
        lclString += "Bytes Received: " + LocalUsage.bytesReceived + "\n\r";
    }

Hinweis Führen Sie ähnliche Schritte zum Abrufen zeitspezifischer Kosteninformationen für Verbindungen aus, die keine Internetkonnektivität bereitstellen. Der Unterschied liegt in der ersten Enumeration der verfügbaren Verbindungsprofile mit NetworkInformation.getConnectionProfiles.

Verhaltensunterschiede zwischen Windows Store-Apps und Windows Phone-Store-Apps

Die GetNetworkUsageAsync-Methode verhält sich unter Windows 8.1 und Windows Phone 8.1 unterschiedlich. Wenn die GetNetworkUsageAsync-Methode unter Windows Phone aufgerufen wird, ist im zurückgegebenen Array von NetworkUsage-Objekten die ConnectionDuration-Eigenschaft immer auf 0 gesetzt, da diese Eigenschaft unter Windows Phone nicht unterstützt wird.