NetworkInformation.GetConnectionProfiles Método

Definição

Namespace:

Windows.Networking.Connectivity

Obtém uma lista de perfis para conexões, ativas ou não, no computador 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)

Retornos

IVectorView<ConnectionProfile>

IReadOnlyList<ConnectionProfile>

Uma matriz de objetos ConnectionProfile .

Comentários

O exemplo a seguir demonstra como recuperar um ConnectionProfile. A função chama getConnectionProfiles para recuperar todas as conexões disponíveis em um dispositivo e exibir usando uma lista. Como alternativa, seu aplicativo pode chamar getInternetConnectionProfile para recuperar o ConnectionProfile que representa a conexão usada atualmente para conectividade com a Internet.

Nota Para a implementação do método getConnectionProfileInfo no código abaixo e para obter exemplos adicionais de como os métodos de classe NetworkInformation são implementados para recuperar perfis de conexão, consulte Início Rápido: Recuperando informações de conexão de rede.

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