Поделиться через


ConnectionProfile Класс

Определение

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

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
Атрибуты

Требования к 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()

Асинхронно пытается удалить этот профиль подключения; операция может быть выполнена или не выполнена. Проверьте возвращаемое значение, чтобы определить результат операции.

Применяется к

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