ConnectionProfile Classe

Definição

Namespace:

Windows.Networking.Connectivity

Representa uma conexão de rede, que inclui a rede conectada no momento ou conexões de rede anteriores. Fornece informações sobre as estatísticas de conectividade e status de conexão.

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

Herança

Object Platform::Object IInspectable ConnectionProfile

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A função de exemplo a seguir demonstra como recuperar dados de um 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";
}

Para obter mais exemplos de como esses métodos de classe são implementados para acessar informações de conexão, consulte Início Rápido: Recuperando informações de conexão de rede.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1.709	16299	GetProviderNetworkUsageAsync
1809	17763	Candelete
1809	17763	TryDeleteAsync

Propriedades

CanDelete	Obtém um valor que indica se é possível ou não excluir esse perfil de conexão. Isso pode ajudar a determinar se TryDeleteAsync provavelmente terá êxito.
IsWlanConnectionProfile	Obtém um valor que indica se o perfil de conexão é uma conexão WLAN (WiFi). Isso determina se WlanConnectionProfileDetails é nulo ou não.
IsWwanConnectionProfile	Obtém um valor que indica se o perfil de conexão é uma conexão WWAN (móvel). Isso determina se WwanConnectionProfileDetails é nulo ou não.
NetworkAdapter	Obtém o objeto que representa o adaptador de rede que fornece conectividade para a conexão.
NetworkSecuritySettings	Recupera as configurações de segurança da rede.
ProfileName	Obtém o nome do perfil de conexão.
ServiceProviderGuid	Obtém a ID do operador de rede que provisionou o perfil de conexão.
WlanConnectionProfileDetails	Obtém um objeto WlanConnectionProfileDetails que fornece um método para recuperar informações específicas para uma conexão WLAN (WiFi).
WwanConnectionProfileDetails	Obtém um objeto WwanConnectionProfileDetails que contém as propriedades e os métodos usados para recuperar informações específicas para conexões de banda larga móvel.

Métodos

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Obtém dados de uso de rede para cada aplicativo individual.
GetConnectionCost()	Obtém as informações de custo da conexão.
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	Obtém uma lista de objetos ConnectivityInterval , que indicam o carimbo de data/hora de quando a conexão de rede começou e um período de tempo durante essa conexão.
GetDataPlanStatus()	Obtém o status atual do plano de dados associado à conexão.
GetDomainConnectivityLevel()	Obtém o status de autenticação de domínio atual para uma conexão de rede. Os valores possíveis são definidos por DomainConnectivityLevel.
GetLocalUsage(DateTime, DateTime)	Observação GetLocalUsage pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetNetworkUsageAsync Obtém o uso estimado de dados para uma conexão durante um período específico.
GetLocalUsage(DateTime, DateTime, RoamingStates)	Observação GetLocalUsage pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetNetworkUsageAsync Obtém o uso estimado de dados para uma conexão durante um período específico de tempo e estado de roaming.
GetNetworkConnectivityLevel()	Obtém o nível de conectividade de rede para essa conexão. Esse valor indica quais recursos de rede, se houver, estão disponíveis no momento.
GetNetworkNames()	Recupera nomes associados à rede com a qual a conexão está estabelecida no momento.
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)	Obtém uma lista do tráfego de dados estimado e da duração da conexão durante um período de tempo especificado, para um estado de uso de rede específico. DataUsageGranularity é usado para indicar a granularidade desejada dos dados retornados e afeta o comprimento da lista retornada. NetworkUsageStates é usado para indicar a configuração de uso de rede desejada.
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Retorna os bytes enviados e bytes recebidos para cada combinação MCC e MNC (a combinação é representada por um ProviderId).
GetSignalBars()	Obtém um valor que indica o número atual de barras de sinal exibidas pela interface do usuário do Windows para a conexão.
IsDomainAuthenticatedBy(DomainAuthenticationKind)	Consulta se o método de autenticação de domínio especificado foi bem-sucedido para esse perfil de conexão.
TryDeleteAsync()	Tenta de forma assíncrona excluir esse perfil de conexão; a operação pode ou não ser bem-sucedida. Examine o valor retornado para determinar o resultado da operação.

Confira também

• NetworkInformation.FindConnectionProfilesAsync