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	取得布建連線設定檔的網路操作員識別碼。
WlanConnectionProfileDetails	取得 WlanConnectionProfileDetails 物件，這個物件提供擷取 WLAN (WiFi) 連線特定資訊的方法。
WwanConnectionProfileDetails	取得 WwanConnectionProfileDetails 物件，其中包含用來擷取行動寬頻連線特定資訊的屬性和方法。

方法

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	取得每個個別應用程式的網路使用量資料。
GetConnectionCost()	取得連接的成本資訊。
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	取得 ConnectivityInterval 物件的清單，指出網路連線開始時的時間戳記，以及該連線持續時間的時間範圍。
GetDataPlanStatus()	取得與連接相關聯的通話方案目前狀態。
GetDomainConnectivityLevel()	取得網路連線的目前網域驗證狀態。 可能的值為 DomainConnectivityLevel所定義。
GetLocalUsage(DateTime, DateTime)	注意 Windows 8.1之後，可能會變更或無法使用 GetLocalUsage 版本。 請改用 GetNetworkUsageAsync 取得連接在特定期間內預估的資料使用量。
GetLocalUsage(DateTime, DateTime, RoamingStates)	注意 Windows 8.1之後，可能會變更或無法使用 GetLocalUsage 版本。 請改用 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