ConnectionProfile Kelas

Definisi

Ruang nama:

Windows.Networking.Connectivity

Mewakili koneksi jaringan, yang mencakup jaringan yang saat ini tersambung atau koneksi jaringan sebelumnya. Menyediakan informasi tentang status koneksi dan statistik konektivitas.

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

Warisan

Object Platform::Object IInspectable ConnectionProfile

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Contoh fungsi berikut menunjukkan cara mengambil data dari 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";
}

Untuk contoh selengkapnya tentang bagaimana metode kelas ini diterapkan untuk mengakses informasi koneksi, lihat Mulai Cepat: Mengambil informasi koneksi jaringan.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1709	16299	GetProviderNetworkUsageAsync
1809	17763	CanDelete
1809	17763	TryDeleteAsync

Properti

CanDelete	Mendapatkan nilai yang menunjukkan apakah profil koneksi ini dapat dihapus atau tidak. Ini dapat membantu menentukan apakah TryDeleteAsync kemungkinan akan berhasil.
IsWlanConnectionProfile	Mendapatkan nilai yang menunjukkan apakah profil koneksi adalah koneksi WLAN (WiFi). Ini menentukan apakah WlanConnectionProfileDetails null atau tidak.
IsWwanConnectionProfile	Mendapatkan nilai yang menunjukkan apakah profil koneksi adalah koneksi WWAN (seluler). Ini menentukan apakah WwanConnectionProfileDetails null atau tidak.
NetworkAdapter	Mendapatkan objek yang mewakili adaptor jaringan yang menyediakan konektivitas untuk koneksi.
NetworkSecuritySettings	Mengambil pengaturan keamanan untuk jaringan.
ProfileName	Mendapatkan nama profil koneksi.
ServiceProviderGuid	Mendapatkan ID operator jaringan yang menyediakan profil koneksi.
WlanConnectionProfileDetails	Mendapatkan objek WlanConnectionProfileDetails yang menyediakan metode untuk mengambil informasi khusus untuk koneksi WLAN (WiFi).
WwanConnectionProfileDetails	Mendapatkan objek WwanConnectionProfileDetails yang berisi properti dan metode yang digunakan untuk mengambil informasi khusus untuk koneksi broadband seluler.

Metode

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Mendapatkan data penggunaan jaringan untuk setiap aplikasi individual.
GetConnectionCost()	Mendapatkan informasi biaya untuk koneksi.
GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)	Mendapatkan daftar objek ConnectivityInterval , yang menunjukkan tanda waktu ketika koneksi jaringan dimulai, dan rentang waktu selama durasi koneksi tersebut.
GetDataPlanStatus()	Mendapatkan status paket data saat ini yang terkait dengan koneksi.
GetDomainConnectivityLevel()	Mendapatkan status autentikasi domain saat ini untuk koneksi jaringan. Nilai yang mungkin ditentukan oleh DomainConnectivityLevel.
GetLocalUsage(DateTime, DateTime)	Catatan GetLocalUsage dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan GetNetworkUsageAsync Mendapatkan perkiraan penggunaan data untuk koneksi selama periode waktu tertentu.
GetLocalUsage(DateTime, DateTime, RoamingStates)	Catatan GetLocalUsage dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan GetNetworkUsageAsync Mendapatkan perkiraan penggunaan data untuk koneksi selama periode waktu dan status roaming tertentu.
GetNetworkConnectivityLevel()	Mendapatkan tingkat konektivitas jaringan untuk koneksi ini. Nilai ini menunjukkan sumber daya jaringan apa, jika ada, yang saat ini tersedia.
GetNetworkNames()	Mengambil nama yang terkait dengan jaringan yang koneksinya saat ini dibuat.
GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)	Mendapatkan daftar perkiraan lalu lintas data dan durasi koneksi selama periode waktu tertentu, untuk status penggunaan jaringan tertentu. DataUsageGranularity digunakan untuk menunjukkan granularitas yang diinginkan dari data yang dikembalikan dan memengaruhi panjang daftar yang dikembalikan. NetworkUsageStates digunakan untuk menunjukkan konfigurasi penggunaan jaringan yang diinginkan.
GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)	Mengembalikan byte yang dikirim dan byte yang diterima untuk setiap kombinasi MCC dan MNC (kombinasi diwakili oleh ProviderId).
GetSignalBars()	Mendapatkan nilai yang menunjukkan jumlah bilah sinyal saat ini yang ditampilkan oleh UI Windows untuk koneksi.
IsDomainAuthenticatedBy(DomainAuthenticationKind)	Kueri apakah metode autentikasi domain yang ditentukan berhasil untuk profil koneksi ini.
TryDeleteAsync()	Secara asinkron mencoba menghapus profil koneksi ini; operasi mungkin atau mungkin tidak berhasil. Periksa nilai pengembalian untuk menentukan hasil operasi.

Lihat juga

• NetworkInformation.FindConnectionProfilesAsync