ConnectionProfile Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 ConnectionProfilePublic NotInheritable Class ConnectionProfile- Herança
- Atributos
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. |