Partager via

ConnectionProfile Classe

  • Référence

Définition

Espace de noms:
Windows.Networking.Connectivity
Modifier

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.

S’applique à

Voir aussi