Compartir a través de


ConnectionProfile Clase

Definición

Representa una conexión de red, que incluye la red conectada actualmente o las conexiones de red anteriores. Proporciona información sobre el estado de conexión y las estadísticas de conectividad.

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
Herencia
Object Platform::Object IInspectable ConnectionProfile
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La siguiente función de ejemplo muestra cómo recuperar datos de 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";
}

Para obtener más ejemplos de cómo se implementan estos métodos de clase para acceder a la información de conexión, consulte Inicio rápido: Recuperación de información de conexión de red.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1709 16299 GetProviderNetworkUsageAsync
1809 17763 CanDelete
1809 17763 TryDeleteAsync

Propiedades

CanDelete

Obtiene un valor que indica si es posible eliminar este perfil de conexión o no. Esto puede ayudar a determinar si TryDeleteAsync es probable que se realice correctamente.

IsWlanConnectionProfile

Obtiene un valor que indica si el perfil de conexión es una conexión WLAN (WiFi). Esto determina si WlanConnectionProfileDetails es null o no.

IsWwanConnectionProfile

Obtiene un valor que indica si el perfil de conexión es una conexión WWAN (móvil). Esto determina si WwanConnectionProfileDetails es null o no.

NetworkAdapter

Obtiene el objeto que representa el adaptador de red que proporciona conectividad para la conexión.

NetworkSecuritySettings

Recupera la configuración de seguridad de la red.

ProfileName

Obtiene el nombre del perfil de conexión.

ServiceProviderGuid

Obtiene el identificador del operador de red que aprovisionó el perfil de conexión.

WlanConnectionProfileDetails

Obtiene un objeto WlanConnectionProfileDetails que proporciona un método para recuperar información específica de una conexión WLAN (WiFi).

WwanConnectionProfileDetails

Obtiene un objeto WwanConnectionProfileDetails que contiene las propiedades y los métodos utilizados para recuperar información específica de las conexiones de banda ancha móvil.

Métodos

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)

Obtiene los datos de uso de red para cada aplicación individual.

GetConnectionCost()

Obtiene la información de costo de la conexión.

GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)

Obtiene una lista de objetos ConnectivityInterval , que indican la marca de tiempo para el inicio de la conexión de red y un intervalo de tiempo durante la duración de esa conexión.

GetDataPlanStatus()

Obtiene el estado actual del plan de datos asociado a la conexión.

GetDomainConnectivityLevel()

Obtiene el estado de autenticación de dominio actual para una conexión de red. Los valores posibles se definen mediante DomainConnectivityLevel.

GetLocalUsage(DateTime, DateTime)

Nota

GetLocalUsage puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetNetworkUsageAsync.

Obtiene el uso de datos estimado para una conexión durante un período de tiempo específico.

GetLocalUsage(DateTime, DateTime, RoamingStates)

Nota

GetLocalUsage puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetNetworkUsageAsync.

Obtiene el uso de datos estimado para una conexión durante un período de tiempo específico y el estado de itinerancia.

GetNetworkConnectivityLevel()

Obtiene el nivel de conectividad de red para esta conexión. Este valor indica qué recursos de red, si los hay, están disponibles actualmente.

GetNetworkNames()

Recupera los nombres asociados a la red con la que se establece actualmente la conexión.

GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)

Obtiene una lista del tráfico de datos estimado y la duración de la conexión durante un período de tiempo especificado para un estado de uso de red específico.

DataUsageGranularity se usa para indicar la granularidad deseada de los datos devueltos y afecta a la longitud de la lista devuelta. NetworkUsageStates se usa para indicar la configuración de uso de red deseada.

GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)

Devuelve los bytes enviados y bytes recibidos para cada combinación de MCC y MNC (la combinación se representa mediante un ProviderId).

GetSignalBars()

Obtiene un valor que indica el número actual de barras de señal mostradas por la interfaz de usuario de Windows para la conexión.

IsDomainAuthenticatedBy(DomainAuthenticationKind)

Consulta si el método de autenticación de dominio especificado se realizó correctamente para este perfil de conexión.

TryDeleteAsync()

Intenta eliminar este perfil de conexión de forma asincrónica; la operación puede o no realizarse correctamente. Examine el valor devuelto para determinar el resultado de la operación.

Se aplica a

Consulte también