GetConnectionProfiles | getConnectionProfiles-Methode

NetworkInformation.GetConnectionProfiles | getConnectionProfiles Method

Ruft eine Liste von Profilen für die Verbindungen ab, aktiv oder nicht, die derzeit auf dem lokalen Computer eingerichtet sind.

Syntax


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

Parameter

Methode besitzt keine Parameter.

Rückgabewert

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

Ein Array von ConnectionProfile-Objekten.

Hinweise

Das folgende Beispiel veranschaulicht das Abrufen eines ConnectionProfile. Die Funktion ruft getConnectionProfiles ab, um alle verfügbaren Verbindungen auf einem Gerät und einer Anzeige mithilfe einer Liste abzurufen. Alternativ kann die Anwendung getInternetConnectionProfile aufrufen, um ConnectionProfile abzurufen, das die Verbindung darstellt, die derzeit für Internet-Konnektivität verwendet wird.


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

Weitere Beispiele dafür, wie NetworkInformation-Klassenmethoden implementiert werden, um Verbindungsprofile abzurufen, finden Sie unter Quickstart: Abrufen von Netzwerkverbindungsdaten.

Windows Phone 8

Diese API wird nicht implementiert und löst beim Aufruf eine Ausnahme aus. Weitere Informationen finden Sie unter Windows Phone Runtime API.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Mindestens unterstütztes Telefon

Windows Phone 8 [nicht implementiert, siehe Hinweise]

Namespace

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

Metadaten

Windows.winmd

Siehe auch

NetworkInformation

 

 

Anzeigen:
© 2017 Microsoft