ConnectionProfile Clase

Definición

Espacio de nombres:

Windows.Networking.Connectivity

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

ContractVersionAttribute MarshalingBehaviorAttribute

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.

Consulte también

• NetworkInformation.FindConnectionProfilesAsync