NetworkInformation.GetConnectionProfiles Méthode

Définition

Espace de noms:

Windows.Networking.Connectivity

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

public:
 static IVectorView<ConnectionProfile ^> ^ GetConnectionProfiles();

 static IVectorView<ConnectionProfile> GetConnectionProfiles();

public static IReadOnlyList<ConnectionProfile> GetConnectionProfiles();

function getConnectionProfiles()

Public Shared Function GetConnectionProfiles () As IReadOnlyList(Of ConnectionProfile)

Retours

IVectorView<ConnectionProfile>

IReadOnlyList<ConnectionProfile>

Tableau d’objets ConnectionProfile .

Remarques

L’exemple suivant montre comment récupérer un ConnectionProfile. La fonction appelle getConnectionProfiles pour récupérer toutes les connexions disponibles sur un appareil et les afficher à l’aide d’une liste. Votre application peut également appeler getInternetConnectionProfile pour récupérer le ConnectionProfile représentant la connexion actuellement utilisée pour la connectivité Internet.

Note Pour l’implémentation de la méthode getConnectionProfileInfo dans le code ci-dessous, et pour obtenir des exemples supplémentaires de 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.

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");
    }
}