NetworkInformation.GetConnectionProfiles | getConnectionProfiles Method

Obtient une liste de profils pour les connexions, actives ou autres, sur l'ordinateur local.

Syntaxe


var iVectorView = Windows.Networking.Connectivity.NetworkInformation.getConnectionProfiles();

Paramètres

Ce Méthode n'a aucun paramètre.

Valeur de retour

Type: IVectorView<ConnectionProfile> [JavaScript/C++] | System.Collections.Generic.IReadOnlyList<ConnectionProfile> [.NET]

Tableau d'objets ConnectionProfile.

Remarques

L'exemple suivant montre comment récupérer ConnectionProfile. La fonction appelle getConnectionProfiles pour récupérer toutes les connexions disponibles sur un périphérique et un écran qui utilisent une liste. Sinon, votre application peut appeler getInternetConnectionProfile pour récupérer le ConnectionProfile représentant la connexion actuelle utilisée pour la connexion Internet.


function DisplayConnectionProfileList() {
    var profileList = "";
    var ConnectionProfiles = networkInfo.getConnectionProfiles();
        if (ConnectionProfiles.length !== 0) {
            for (var i = 0; i < ConnectionProfiles.length; i++) {

                //Display Connection profile info for each profile by passing it
																//to a function that accesses and displays the connection properties
                profileList += getConnectionProfileInfo(ConnectionProfiles[i]);
                profileList += "-------------------------\n\r";
            }
            mySample.displayStatus(profileList);
        }
        else {
            mySample.displayStatus("No profiles found");
        }
    }

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

Pour obtenir des exemples supplémentaires sur la façon dont les méthodes de classe NetworkInformation sont implémentées pour récupérer des profils de connexion, consultez Démarrage rapide : récupération des informations de connexion réseau.

Windows Phone 8

Cette API n'est pas implémentée et lève une exception si elle est appelée. Consultez API de runtime Windows Phone.

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Téléphone minimal pris en charge

Windows Phone 8 [non implémenté, consultez la section Notes]

Espace de noms

Windows.Networking.Connectivity
Windows::Networking::Connectivity [C++]

Métadonnées

Windows.winmd

Voir aussi

NetworkInformation

 

 

Afficher:
© 2015 Microsoft