NetworkInformation.GetConnectionProfiles Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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");
}
}