ConnectionProfile Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Networking.Connectivity

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

NetworkInformation.FindConnectionProfilesAsync

Condividi tramite