次の方法で共有


ConnectionProfile クラス

定義

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

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
属性

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()

この接続プロファイルを非同期的に削除しようとします。操作が成功する場合と失敗する場合があります。 戻り値を調べて、操作の結果を確認します。

適用対象

こちらもご覧ください