ConnectionProfile クラス

リファレンス

定義

名前空間:: Windows.Networking.Connectivity

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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	WLAN (WiFi) 接続に固有の情報を取得するためのメソッドを提供する WlanConnectionProfileDetails オブジェクトを取得します。
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