NetworkInformation.GetConnectionProfiles Methode

Definition

Namespace:

Windows.Networking.Connectivity

Ruft eine Liste der Profile für aktive oder anderweitige Verbindungen auf dem lokalen Computer ab.

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

 static IVectorView<ConnectionProfile> GetConnectionProfiles();

public static IReadOnlyList<ConnectionProfile> GetConnectionProfiles();

function getConnectionProfiles()

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

Gibt zurück

IVectorView<ConnectionProfile>

IReadOnlyList<ConnectionProfile>

Ein Array von ConnectionProfile-Objekten .

Hinweise

Im folgenden Beispiel wird veranschaulicht, wie Ein ConnectionProfile abgerufen wird. Die Funktion ruft getConnectionProfiles auf, um alle verfügbaren Verbindungen auf einem Gerät abzurufen und mithilfe einer Liste anzuzeigen. Alternativ kann Ihre App getInternetConnectionProfile aufrufen, um das ConnectionProfile abzurufen, das die Verbindung darstellt, die derzeit für die Internetverbindung verwendet wird.

Hinweis Informationen zur Implementierung der getConnectionProfileInfo-Methode im folgenden Code und weitere Beispiele für die Implementierung von NetworkInformation-Klassenmethoden zum Abrufen von Verbindungsprofilen finden Sie unter Schnellstart: Abrufen von Netzwerkverbindungsinformationen.

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