ConnectionProfile Class

現在接続されているネットワークまたは前のネットワーク接続を含むネットワーク接続を表します。 接続の状態と接続性の統計値に関する情報を提供します。

構文


var connectionProfile = getInternetConnectionProfile();

属性

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

メンバー

ConnectionProfileクラス には次の種類のメンバーがあります。

メソッド

The ConnectionProfile クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
GetConnectionCost Gets the cost information for the connection.
GetConnectivityIntervalsAsync Gets a list of ConnectivityInterval objects, which indicate the timestamp for when the network connection began, and a time-span for the duration of that connection.
GetDataPlanStatus Gets the current status of the data plan associated with the connection.
GetDomainConnectivityLevel Gets the current domain authentication status for a network connection. Possible values are defined by DomainConnectivityLevel.
GetLocalUsage(DateTime, DateTime) Gets the estimated data usage for a connection during over a specific period of time.
GetLocalUsage(DateTime, DateTime, RoamingStates) Gets the estimated data usage for a connection over a specific period of time and roaming state.
GetNetworkConnectivityLevel Gets the network connectivity level for this connection. This value indicates what network resources, if any, are currently available.
GetNetworkNames Retrieves names associated with the network with which the connection is currently established.
GetNetworkUsageAsync Gets a list of the estimated data traffic and connection duration over a specified period of time, for a specific network usage state.
GetSignalBars Gets a value that indicates the current number of signal bars displayed by the Windows UI for the connection.

 

プロパティ

ConnectionProfileクラス には次のプロパティがあります。

プロパティアクセスの種類説明

IsWlanConnectionProfile

読み取り専用Gets a value that indicates if connection profile is a WLAN (WiFi) connection. This determines whether or not WlanConnectionProfileDetails is null.

IsWwanConnectionProfile

読み取り専用Gets a value that indicates if connection profile is a WWAN (mobile) connection. This determines whether or not WwanConnectionProfileDetails is null.

NetworkAdapter

読み取り専用Gets the object representing the network adapter providing connectivity for the connection.

NetworkSecuritySettings

読み取り専用Retrieves the security settings for the network.

ProfileName

読み取り専用Gets the name of the connection profile.

ServiceProviderGuid

読み取り専用Gets the ID of the network operator who provisioned the connection profile.

WlanConnectionProfileDetails

読み取り専用Contains properties and methods defined by WlanConnectionProfile that are specific to WLAN (WiFi) connections.

WwanConnectionProfileDetails

読み取り専用Contains the properties and methods defined by WwanConnectionProfile that are specific to mobile broadband connections.

 

解説

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 8 [Windows ストア アプリ, デスクトップ アプリ]

最小限サポートされるサーバー

サポートなし [Windows ストア アプリ, デスクトップ アプリ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Networking.Connectivity
Windows::Networking::Connectivity [C++]

メタデータ

Windows.winmd

 

 

表示:
© 2014 Microsoft