Langage: HTML | XAML

Comment récupérer des informations de carte réseau et de localité (HTML)

Applies to Windows and Windows Phone

Cette rubrique montre comment récupérer les objets LanIdentifier associés à des cartes réseau, et accéder à des informations permettant de déterminer leur emplacement relatif au sein de l’infrastructure réseau à l’aide des classes de l’espace de noms Windows.Networking.Connectivity.

Un objet LanIdentifier définit les méthodes qu’une application utilise pour récupérer les valeurs d’ID d’infrastructure/de port permettant de déterminer un emplacement, ainsi que la valeur d’ID associée à une carte réseau. Cet ID est exprimé sous forme de propriété ConnectionProfile pour indiquer son association à la connexion réseau.

Ce que vous devez savoir

Technologies

Prérequis

Les exemples suivants utilisent JavaScript et s’appuient sur l’exemple d’informations réseau. Pour obtenir une aide générale sur la création d’une application Windows Runtime en JavaScript, voir Créer votre première application Windows Runtime en JavaScript.

Récupérer tous les objets LanIdentifier

Le premier exemple de fonction appelle la méthode NetworkInformation.getLanIdentifiers pour extraire un tableau d’objets LanIdentifier.


var networkInfo = Windows.Networking.Connectivity.NetworkInformation;

function DisplayLanIdentifiers() {
     var lanIdentifier = "";
     try {
         var lanIdentifiers = networkInfo.getLanIdentifiers();
         if (lanIdentifiers.length !== 0) {
             lanIdentifier += "Number of LAN Identifiers retrieved: " + lanIdentifiers.length + "\n\r";
             lanIdentifier += "=============================================\n\r";
             for (var i = 0; i < lanIdentifiers.length; i++) {
                 //Display Lan Identifier data for each identifier
                 lanIdentifier += getLanIdentifierData(lanIdentifiers[i]);
                 lanIdentifier += "----------------------------------------------------------------\n\r";
             }
             mySample.displayStatus(lanIdentifier);
         }
         else {
             mySample.displayStatus("No LAN identifier data found");
         }
     }

     catch (e) {
         mySample.displayError("Exception Caught: " + e + "\n\r");
     }
 }


Afficher les propriétés d’un objet LanIdentifier

Nous passons ensuite un objet LanIdentifier retourné au cours de l’étape précédente à l’exemple de fonction suivant, afin d’afficher les valeurs d’ID d’infrastructure, d’ID de port et d’ID de carte réseau spécifiques.


var networkInfo = Windows.Networking.Connectivity.NetworkInformation;
  
function getLanIdentifierData(lanIdentifier) {
    var lanIdentifierData = "";
    var i = 0;
    try {
        if (lanIdentifier === null) {
            return "";
        }
        if (lanIdentifier.infrastructureId !== null) {
            lanIdentifierData += "Infrastructure Type: " + lanIdentifier.infrastructureId.type + "\n\r";
            lanIdentifierData += "Infrastructure Value: [";
            for (i = 0; i < lanIdentifier.infrastructureId.value.length; i++) {
                //Display the Infrastructure value array
                lanIdentifierData += lanIdentifier.infrastructureId.value[i].toString(16) + " ";
            }
            lanIdentifierData += "]\n\r";
        }
        if (lanIdentifier.portId !== null) {
            lanIdentifierData += "Port Type : " + lanIdentifier.portId.type + "\n\r";
            lanIdentifierData += "Port Value: [";
            for (i = 0; i < lanIdentifier.portId.value.length; i++) {
                //Display the PortId value array
                lanIdentifierData += lanIdentifier.portId.value[i].toString(16) + " ";
            }
            lanIdentifierData += "]\n\r";
        }
        if (lanIdentifier.networkAdapterId !== null) {
            lanIdentifierData += "Network Adapter Id : " + lanIdentifier.networkAdapterId + "\n\r";
        }
    }
    catch (e) {
        mySample.displayError("Exception Caught: " + e + "\n\r");
    }
    return lanIdentifierData;
}


Rubriques associées

Autre
Créer votre première application Windows Runtime en JavaScript
Comment gérer les exceptions dans les applications réseau
Comment gérer les contraintes liées au coût des connexions réseau limitées
Comment gérer les événements de connexion réseau et les changements de disponibilité
Comment récupérer des informations de connexion réseau
Comment récupérer des données d’utilisation de connexion réseau
Référence
LanIdentifier
LanIdentifierData
NetworkAdapter
NetworkInformation
NetworkInformation.getLanIdentifiers
Exemples
Exemple d’informations réseau
Exemple d’arrière-plan d’état du réseau

 

 

Afficher:
© 2014 Microsoft