NetworkInformation.GetConnectionProfiles 方法

定义

命名空间:

Windows.Networking.Connectivity

获取本地计算机上的连接（活动或其他）的配置文件列表。

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

 static IVectorView<ConnectionProfile> GetConnectionProfiles();

public static IReadOnlyList<ConnectionProfile> GetConnectionProfiles();

function getConnectionProfiles()

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

返回

IVectorView<ConnectionProfile>

IReadOnlyList<ConnectionProfile>

ConnectionProfile 对象的数组。

注解

以下示例演示如何检索 ConnectionProfile。 函数调用 getConnectionProfiles 以检索设备上的所有可用连接并使用列表显示。 或者，应用可以调用 getInternetConnectionProfile 来检索表示当前用于 Internet 连接的 连接的 ConnectionProfile 。

注意 有关以下代码中 getConnectionProfileInfo 方法的实现，以及有关如何实现 NetworkInformation 类方法以检索连接配置文件的其他示例，请参阅 快速入门：检索网络连接信息。

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