ConnectionProfile Classe

Définition

Espace de noms:

Windows.Networking.Connectivity

Représente une connexion réseau, qui inclut le réseau actuellement connecté ou les connexions réseau antérieures. Fournit des informations sur la status de connexion et les statistiques de connectivité.

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

Héritage

Object Platform::Object IInspectable ConnectionProfile

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

L’exemple de fonction suivant montre comment récupérer des données à partir d’un 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";
}

Pour obtenir d’autres exemples de la façon dont ces méthodes de classe sont implémentées pour accéder aux informations de connexion, consultez Démarrage rapide : Récupération des informations de connexion réseau.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1709	16299	GetProviderNetworkUsageAsync
1809	17763	CanDelete
1809	17763	TryDeleteAsync

Propriétés

CanDelete	Obtient une valeur qui indique s’il est possible de supprimer ce profil de connexion. Cela peut aider à déterminer si TryDeleteAsync est susceptible de réussir.
IsWlanConnectionProfile	Obtient une valeur qui indique si le profil de connexion est une connexion WLAN (Wi-Fi). Cela détermine si WlanConnectionProfileDetails a la valeur Null.
IsWwanConnectionProfile	Obtient une valeur qui indique si le profil de connexion est une connexion WWAN (mobile). Cela détermine si WwanConnectionProfileDetails est null ou non.
NetworkAdapter	Obtient l’objet représentant la carte réseau fournissant la connectivité pour la connexion.
NetworkSecuritySettings	Récupère les paramètres de sécurité du réseau.
ProfileName	Obtient le nom du profil de connexion.
ServiceProviderGuid	Obtient l’ID de l’opérateur réseau qui a provisionné le profil de connexion.
WlanConnectionProfileDetails	Obtient un objet WlanConnectionProfileDetails qui fournit une méthode permettant de récupérer des informations spécifiques à une connexion WLAN (WiFi).
WwanConnectionProfileDetails	Obtient un objet WwanConnectionProfileDetails contenant les propriétés et méthodes utilisées pour récupérer des informations spécifiques aux connexions haut débit mobiles.

Méthodes

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Obtient les données d’utilisation réseau pour chaque application individuelle.
GetConnectionCost()	Obtient les informations de coût pour la connexion.
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	Obtient une liste d’objets ConnectivityInterval , qui indiquent l’horodatage du début de la connexion réseau et un intervalle de temps pour la durée de cette connexion.
GetDataPlanStatus()	Obtient la status actuelle du plan de données associé à la connexion.
GetDomainConnectivityLevel()	Obtient le status d’authentification de domaine actuel pour une connexion réseau. Les valeurs possibles sont définies par DomainConnectivityLevel.
GetLocalUsage(DateTime, DateTime)	Notes GetLocalUsage peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetNetworkUsageAsync. Obtient l’utilisation estimée des données pour une connexion pendant une période spécifique.
GetLocalUsage(DateTime, DateTime, RoamingStates)	Notes GetLocalUsage peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetNetworkUsageAsync. Obtient l’utilisation estimée des données pour une connexion sur une période spécifique et un état d’itinérance.
GetNetworkConnectivityLevel()	Obtient le niveau de connectivité réseau pour cette connexion. Cette valeur indique les ressources réseau, le cas échéant, qui sont actuellement disponibles.
GetNetworkNames()	Récupère les noms associés au réseau avec lequel la connexion est actuellement établie.
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)	Obtient la liste du trafic de données estimé et de la durée de connexion sur une période spécifiée, pour un état d’utilisation du réseau spécifique. DataUsageGranularity est utilisé pour indiquer la granularité souhaitée des données retournées et affecte la longueur de la liste retournée. NetworkUsageStates est utilisé pour indiquer la configuration d’utilisation réseau souhaitée.
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Retourne les octets envoyés et les octets reçus pour chaque combinaison MCC et MNC (la combinaison est représentée par un ProviderId).
GetSignalBars()	Obtient une valeur qui indique le nombre actuel de barres de signal affichées par l’interface utilisateur Windows pour la connexion.
IsDomainAuthenticatedBy(DomainAuthenticationKind)	Interroge si la méthode d’authentification de domaine spécifiée a réussi pour ce profil de connexion.
TryDeleteAsync()	Tente de façon asynchrone de supprimer ce profil de connexion ; l’opération peut ou non réussir. Examinez la valeur de retour pour déterminer le résultat de l’opération.

Voir aussi

• NetworkInformation.FindConnectionProfilesAsync