ConnectionProfile Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Networking.Connectivity
Modifica

Rappresenta una connessione di rete, che include la rete attualmente connessa o le connessioni di rete precedenti. Fornisce informazioni sullo stato della connessione e sulle statistiche di connettività.

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
Ereditarietà
Object Platform::Object IInspectable ConnectionProfile
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La funzione di esempio seguente illustra come recuperare i dati da 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";
}

Per altri esempi di come questi metodi di classe vengono implementati per accedere alle informazioni di connessione, vedere Avvio rapido: Recupero delle informazioni di connessione di rete.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1709 16299 GetProviderNetworkUsageAsync
1809 17763 CanDelete
1809 17763 TryDeleteAsync

Proprietà

CanDelete

Ottiene un valore che indica se è possibile eliminare il profilo di connessione. Ciò può aiutare a determinare se TryDeleteAsync è probabile che abbia esito positivo.
IsWlanConnectionProfile

Ottiene un valore che indica se il profilo di connessione è una connessione WLAN (WiFi). Ciò determina se WlanConnectionProfileDetails è null.
IsWwanConnectionProfile

Ottiene un valore che indica se il profilo di connessione è una connessione WWAN (mobile). Ciò determina se WwanConnectionProfileDetails è null.
NetworkAdapter

Ottiene l'oggetto che rappresenta la scheda di rete che fornisce la connettività per la connessione.
NetworkSecuritySettings

Recupera le impostazioni di sicurezza per la rete.
ProfileName

Ottiene il nome del profilo di connessione.
ServiceProviderGuid

Ottiene l'ID dell'operatore di rete che ha effettuato il provisioning del profilo di connessione.
WlanConnectionProfileDetails

Ottiene un oggetto WlanConnectionProfileDetails che fornisce un metodo per recuperare informazioni specifiche di una connessione WLAN (WiFi).
WwanConnectionProfileDetails

Ottiene un oggetto WwanConnectionProfileDetails contenente le proprietà e i metodi usati per recuperare informazioni specifiche per le connessioni a banda larga mobile.

Metodi

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)

Ottiene i dati di utilizzo della rete per ogni singola applicazione.
GetConnectionCost()

Ottiene le informazioni sui costi per la connessione.
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)

Ottiene un elenco di oggetti ConnectivityInterval , che indicano il timestamp per quando la connessione di rete è iniziata e un intervallo di tempo per la durata di tale connessione.
GetDataPlanStatus()

Ottiene lo stato corrente del piano di dati associato alla connessione.
GetDomainConnectivityLevel()

Ottiene lo stato di autenticazione del dominio corrente per una connessione di rete. I valori possibili sono definiti da DomainConnectivityLevel.
GetLocalUsage(DateTime, DateTime)

Nota

GetLocalUsage può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetNetworkUsageAsync

Ottiene l'utilizzo stimato dei dati per una connessione durante un periodo di tempo specifico.
GetLocalUsage(DateTime, DateTime, RoamingStates)

Nota

GetLocalUsage può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetNetworkUsageAsync

Ottiene l'utilizzo stimato dei dati per una connessione in un periodo di tempo e uno stato roaming specifici.
GetNetworkConnectivityLevel()

Ottiene il livello di connettività di rete per questa connessione. Questo valore indica quali risorse di rete, se presenti, sono attualmente disponibili.
GetNetworkNames()

Recupera i nomi associati alla rete con cui è attualmente stabilita la connessione.
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)

Ottiene un elenco del traffico dati stimato e della durata della connessione in un periodo di tempo specificato, per uno stato di utilizzo di rete specifico.

DataUsageGranularity viene usato per indicare la granularità desiderata dei dati restituiti e influisce sulla lunghezza dell'elenco restituito. NetworkUsageStates viene usato per indicare la configurazione di utilizzo della rete desiderata.
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)

Restituisce i byte inviati e byte ricevuti per ogni combinazione MCC e MNC (la combinazione è rappresentata da un ProviderId).
GetSignalBars()

Ottiene un valore che indica il numero corrente di barre di segnale visualizzate dall'interfaccia utente di Windows per la connessione.
IsDomainAuthenticatedBy(DomainAuthenticationKind)

Esegue una query sul fatto che il metodo di autenticazione del dominio specificato abbia avuto esito positivo per questo profilo di connessione.
TryDeleteAsync()

Tenta in modo asincrono di eliminare questo profilo di connessione; l'operazione può o non riesce. Esaminare il valore restituito per determinare il risultato dell'operazione.

Si applica a

Vedi anche