ConnectionProfile Класс

Определение

Пространство имен:

Windows.Networking.Connectivity

Представляет сетевое подключение, включающее подключенную в данный момент сеть или предыдущие сетевые подключения. Предоставляет сведения о состоянии подключения и статистике подключения.

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

Наследование

Object Platform::Object IInspectable ConnectionProfile

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

В следующем примере функции показано, как получить данные из 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";
}

Дополнительные примеры реализации этих методов класса для доступа к сведениям о подключении см. в разделе Краткое руководство. Получение сведений о сетевом подключении.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1709	16299	GetProviderNetworkUsageAsync
1809	17763	CanDelete
1809	17763	TryDeleteAsync

Свойства

CanDelete	Возвращает значение, указывающее, можно ли удалить этот профиль подключения. Это поможет определить, будет ли tryDeleteAsync успешным.
IsWlanConnectionProfile	Возвращает значение, указывающее, является ли профиль подключения подключением WLAN (Wi-Fi). Это определяет, имеет ли WlanConnectionProfileDetails значение NULL.
IsWwanConnectionProfile	Возвращает значение, указывающее, является ли профиль подключения подключением WWAN (мобильное) подключение. Это определяет, имеет ли WwanConnectionProfileDetails значение NULL.
NetworkAdapter	Возвращает объект , представляющий сетевой адаптер, обеспечивающий подключение для соединения.
NetworkSecuritySettings	Извлекает параметры безопасности для сети.
ProfileName	Возвращает имя профиля подключения.
ServiceProviderGuid	Возвращает идентификатор сетевого оператора, который подготовил профиль подключения.
WlanConnectionProfileDetails	Возвращает объект WlanConnectionProfileDetails , предоставляющий метод получения сведений, относящихся к WLAN-подключению (Wi-Fi).
WwanConnectionProfileDetails	Возвращает объект WwanConnectionProfileDetails , содержащий свойства и методы, используемые для получения сведений, относящихся к мобильным широкополосным подключениям.

Методы

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Возвращает данные об использовании сети для каждого отдельного приложения.
GetConnectionCost()	Возвращает сведения о затратах для подключения.
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	Возвращает список объектов ConnectivityInterval , указывающих метку времени начала сетевого подключения и временной промежуток для длительности этого подключения.
GetDataPlanStatus()	Возвращает текущее состояние плана данных, связанного с подключением.
GetDomainConnectivityLevel()	Возвращает текущее состояние проверки подлинности домена для сетевого подключения. Возможные значения определяются DomainConnectivityLevel.
GetLocalUsage(DateTime, DateTime)	Примечание GetLocalUsage может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте GetNetworkUsageAsync. Возвращает предполагаемое использование данных для подключения в течение определенного периода времени.
GetLocalUsage(DateTime, DateTime, RoamingStates)	Примечание GetLocalUsage может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте GetNetworkUsageAsync. Возвращает предполагаемое использование данных для подключения за определенный период времени и состояние роуминга.
GetNetworkConnectivityLevel()	Возвращает уровень сетевого подключения для этого подключения. Это значение указывает, какие сетевые ресурсы (если таковые имеются) доступны в настоящее время.
GetNetworkNames()	Извлекает имена, связанные с сетью, с которой в настоящее время установлено соединение.
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)	Возвращает список предполагаемого трафика данных и длительности подключения за указанный период времени для определенного состояния использования сети. DataUsageGranularity используется для указания требуемой степени детализации возвращаемых данных и влияет на длину возвращаемого списка. NetworkUsageStates используется для указания требуемой конфигурации использования сети.
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Возвращает отправленные и полученные байты для каждого сочетания MCC и MNC (сочетание представлено Идентификатором поставщика).
GetSignalBars()	Возвращает значение, указывающее текущее количество полос сигнала, отображаемых пользовательским интерфейсом Windows для подключения.
IsDomainAuthenticatedBy(DomainAuthenticationKind)	Запрашивает, успешно ли выполнен указанный метод проверки подлинности домена для этого профиля подключения.
TryDeleteAsync()	Асинхронно пытается удалить этот профиль подключения; операция может быть выполнена или не выполнена. Проверьте возвращаемое значение, чтобы определить результат операции.

См. также раздел

• NetworkInformation.FindConnectionProfilesAsync