ConnectionProfile Klasse

Definition

Namespace:

Windows.Networking.Connectivity

Stellt eine Netzwerkverbindung dar, die entweder das derzeit verbundene Netzwerk oder vorherige Netzwerkverbindungen umfasst. Stellt Informationen zu verbindungs- status und Konnektivitätsstatistiken bereit.

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

Vererbung

Object Platform::Object IInspectable ConnectionProfile

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die folgende Beispielfunktion veranschaulicht, wie Daten aus einem ConnectionProfile abgerufen werden.

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";
}

Weitere Beispiele für die Implementierung dieser Klassenmethoden für den Zugriff auf Verbindungsinformationen finden Sie unter Schnellstart: Abrufen von Netzwerkverbindungsinformationen.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1709	16299	GetProviderNetworkUsageAsync
1809	17763	CanDelete
1809	17763	TryDeleteAsync

Eigenschaften

CanDelete	Ruft einen Wert ab, der angibt, ob dieses Verbindungsprofil gelöscht werden kann. Dadurch kann ermittelt werden, ob TryDeleteAsync wahrscheinlich erfolgreich ist.
IsWlanConnectionProfile	Ruft einen Wert ab, der angibt, ob das Verbindungsprofil eine WLAN-Verbindung (WIFi) ist. Dadurch wird bestimmt, ob WlanConnectionProfileDetails NULL ist.
IsWwanConnectionProfile	Ruft einen Wert ab, der angibt, ob das Verbindungsprofil eine WWAN-Verbindung (Mobile) ist. Dadurch wird bestimmt, ob WwanConnectionProfileDetails NULL ist.
NetworkAdapter	Ruft das -Objekt ab, das den Netzwerkadapter darstellt, der Konnektivität für die Verbindung bereitstellt.
NetworkSecuritySettings	Ruft die Sicherheitseinstellungen für das Netzwerk ab.
ProfileName	Ruft den Namen des Verbindungsprofils ab.
ServiceProviderGuid	Ruft die ID des Netzbetreibers ab, der das Verbindungsprofil bereitgestellt hat.
WlanConnectionProfileDetails	Ruft ein WlanConnectionProfileDetails-Objekt ab, das eine Methode zum Abrufen von Informationen bereitstellt, die speziell für eine WLAN-Verbindung (WIFi) gelten.
WwanConnectionProfileDetails	Ruft ein WwanConnectionProfileDetails-Objekt ab, das die Eigenschaften und Methoden enthält, die zum Abrufen spezifischer Informationen für mobile Breitbandverbindungen verwendet werden.

Methoden

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Ruft Netzwerknutzungsdaten für jede einzelne Anwendung ab.
GetConnectionCost()	Ruft die Kosteninformationen für die Verbindung ab.
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	Ruft eine Liste der ConnectivityInterval-Objekte ab, die den Zeitstempel für den Beginn der Netzwerkverbindung und eine Zeitspanne für die Dauer dieser Verbindung angeben.
GetDataPlanStatus()	Ruft den aktuellen status des Datenplans ab, der der Verbindung zugeordnet ist.
GetDomainConnectivityLevel()	Ruft die aktuelle domänenauthentifizierung status für eine Netzwerkverbindung ab. Mögliche Werte werden von DomainConnectivityLevel definiert.
GetLocalUsage(DateTime, DateTime)	Hinweis GetLocalUsage kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen GetNetworkUsageAsync. Ruft die geschätzte Datennutzung für eine Verbindung während eines bestimmten Zeitraums ab.
GetLocalUsage(DateTime, DateTime, RoamingStates)	Hinweis GetLocalUsage kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen GetNetworkUsageAsync. Ruft die geschätzte Datennutzung für eine Verbindung über einen bestimmten Zeitraum und roamingstatus ab.
GetNetworkConnectivityLevel()	Ruft die Netzwerkkonnektivitätsebene für diese Verbindung ab. Dieser Wert gibt an, welche Netzwerkressourcen derzeit verfügbar sind.
GetNetworkNames()	Ruft Namen ab, die dem Netzwerk zugeordnet sind, mit dem die Verbindung derzeit hergestellt wird.
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)	Ruft eine Liste des geschätzten Datenverkehrs und der Verbindungsdauer für einen bestimmten Zeitraum für einen bestimmten Netzwerknutzungszustand ab. DataUsageGranularity wird verwendet, um die gewünschte Granularität der zurückgegebenen Daten anzugeben und wirkt sich auf die Länge der zurückgegebenen Liste aus. NetworkUsageStates wird verwendet, um die gewünschte Netzwerknutzungskonfiguration anzugeben.
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Gibt die gesendeten und empfangenen Bytes für jede MCC- und MNC-Kombination zurück (die Kombination wird durch eine ProviderId dargestellt).
GetSignalBars()	Ruft einen Wert ab, der die aktuelle Anzahl von Signalbalken angibt, die von der Windows-Benutzeroberfläche für die Verbindung angezeigt werden.
IsDomainAuthenticatedBy(DomainAuthenticationKind)	Fragt ab, ob die angegebene Domänenauthentifizierungsmethode für dieses Verbindungsprofil erfolgreich war.
TryDeleteAsync()	Versucht asynchron, dieses Verbindungsprofil zu löschen. Der Vorgang kann erfolgreich sein oder nicht. Untersuchen Sie den Rückgabewert, um das Ergebnis des Vorgangs zu bestimmen.

Weitere Informationen

• NetworkInformation.FindConnectionProfilesAsync