ConnectionProfile 类

定义

命名空间:

Windows.Networking.Connectivity

表示网络连接，包括当前连接的网络或以前的网络连接。 提供有关连接状态和连接统计信息的信息。

public ref class ConnectionProfile sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectionProfile final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectionProfile

Public NotInheritable Class ConnectionProfile

继承

Object Platform::Object IInspectable ConnectionProfile

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

以下示例函数演示如何从 ConnectionProfile 检索数据。

function getConnectionProfileInfo(connectionProfile) {

     returnString += "Connection Cost Information:\n\r";
     returnString += "===============\n\r";
     var connectionCost = connectionProfile.getConnectionCost();
     returnString += "Cost Type: " + getCostType(connectionCost.networkCostType) + "\n\r";
     returnString += "Roaming: " + connectionCost.roaming + "\n\r";
     returnString += "Over Datalimit: " + connectionCost.overDataLimit + "\n\r";
     returnString += "Approaching Datalimit: " + connectionCost.approachingDataLimit + "\n\r";
}

有关如何实现这些类方法来访问连接信息的更多示例，请参阅 快速入门：检索网络连接信息。

版本历史记录

Windows 版本	SDK 版本	增值
1709	16299	GetProviderNetworkUsageAsync
1809	17763	CanDelete
1809	17763	TryDeleteAsync

属性

CanDelete	获取一个值，该值指示是否可以删除此连接配置文件。 这有助于确定 TryDeleteAsync 是否可能成功。
IsWlanConnectionProfile	获取一个值，该值指示连接配置文件是否为 WLAN (WiFi) 连接。 这将确定 WlanConnectionProfileDetails 是否为 null。
IsWwanConnectionProfile	获取一个值，该值指示连接配置文件是否为 WWAN (移动) 连接。 这将确定 WwanConnectionProfileDetails 是否为 null。
NetworkAdapter	获取表示为连接提供连接的网络适配器的 对象。
NetworkSecuritySettings	检索网络的安全设置。
ProfileName	获取连接配置文件的名称。
ServiceProviderGuid	获取预配连接配置文件的网络操作员的 ID。
WlanConnectionProfileDetails	获取 WlanConnectionProfileDetails 对象，该对象提供检索特定于 WLAN 的信息的方法 (WiFi) 连接。
WwanConnectionProfileDetails	获取一个 WwanConnectionProfileDetails 对象，该对象包含用于检索特定于移动宽带连接的信息的属性和方法。

方法

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	获取每个应用程序的网络使用情况数据。
GetConnectionCost()	获取连接的成本信息。
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	获取 ConnectivityInterval 对象的列表，这些对象指示网络连接开始时间的时间戳，以及该连接持续时间的时间跨度。
GetDataPlanStatus()	获取与连接关联的数据计划的当前状态。
GetDomainConnectivityLevel()	获取网络连接的当前域身份验证状态。 可能的值由 DomainConnectivityLevel 定义。
GetLocalUsage(DateTime, DateTime)	注意 getLocalUsage 在Windows 8.1后可能会更改或不可用于发布。 请改用 GetNetworkUsageAsync 获取在特定时间段内连接的估计数据使用情况。
GetLocalUsage(DateTime, DateTime, RoamingStates)	注意 getLocalUsage 在Windows 8.1后可能会更改或不可用于发布。 请改用 GetNetworkUsageAsync 获取特定时间段内连接和漫游状态的估计数据使用情况。
GetNetworkConnectivityLevel()	获取此连接的网络连接级别。 此值指示当前可用的网络资源（如果有）。
GetNetworkNames()	检索与当前与之建立连接的网络关联的名称。
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)	获取特定网络使用状态在指定时间段内估计的数据流量和连接持续时间的列表。 DataUsageGranularity 用于指示返回数据的所需粒度，并影响返回列表的长度。 NetworkUsageStates 用于指示所需的网络使用情况配置。
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	返回为每个 MCC 和 MNC 组合发送的字节数和接收的字节数， (组合由 ProviderId) 表示。
GetSignalBars()	获取一个值，该值指示 Windows UI 为连接显示的当前信号条数。
IsDomainAuthenticatedBy(DomainAuthenticationKind)	查询此连接配置文件的指定域身份验证方法是否成功。
TryDeleteAsync()	异步尝试删除此连接配置文件;操作可能成功，也可能不成功。 检查返回值以确定操作的结果。

另请参阅

• NetworkInformation.FindConnectionProfilesAsync