NetworkInformation.GetConnectionProfiles Método

Definición

Espacio de nombres:

Windows.Networking.Connectivity

Obtiene una lista de perfiles para las conexiones, activas o de otro modo, en el equipo 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)

Devoluciones

IVectorView<ConnectionProfile>

IReadOnlyList<ConnectionProfile>

Matriz de objetos ConnectionProfile .

Comentarios

En el ejemplo siguiente se muestra cómo recuperar un objeto ConnectionProfile. La función llama a getConnectionProfiles para recuperar todas las conexiones disponibles en un dispositivo y mostrarlas mediante una lista. Como alternativa, la aplicación puede llamar a getInternetConnectionProfile para recuperar connectionProfile que representa la conexión que se usa actualmente para la conectividad a Internet.

Nota Para la implementación del método getConnectionProfileInfo en el código siguiente y para obtener ejemplos adicionales de cómo se implementan los métodos de clase NetworkInformation para recuperar perfiles de conexión, consulte Inicio rápido: Recuperación de información de conexión de red.

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