IPGlobalProperties.GetUnicastAddressesAsync Metode

Definisi

Ruang nama:

System.Net.NetworkInformation

Rakitan:

System.Net.NetworkInformation.dll

Sumber:

IPGlobalProperties.cs

Mengambil tabel alamat IP unicast yang stabil di komputer lokal sebagai operasi asinkron.

public:
 virtual System::Threading::Tasks::Task<System::Net::NetworkInformation::UnicastIPAddressInformationCollection ^> ^ GetUnicastAddressesAsync();

public virtual System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection> GetUnicastAddressesAsync ();

abstract member GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>
override this.GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>

Public Overridable Function GetUnicastAddressesAsync () As Task(Of UnicastIPAddressInformationCollection)

Mengembalikan

Task<UnicastIPAddressInformationCollection>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

NetworkInformationException

Panggilan ke fungsi asli GetAdaptersAddresses gagal.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan Read .

Win32Exception

Panggilan ke fungsi asli NotifyStableUnicastIpAddressTable gagal.

Keterangan

Untuk mendukung koneksi keluar atau menerima koneksi masuk pada antarmuka Teredo, aplikasi perlu memastikan bahwa antarmuka Teredo siap digunakan. Ini karena Teredo dapat masuk ke status tidak aktif ketika tidak digunakan untuk beberapa periode waktu.

Metode ini GetUnicastAddressesAsync akan memungkinkan aplikasi untuk mengambil daftar alamat IP unicast yang stabil sebagai operasi asinkron. IPAddress.IsIPv6Teredo Properti dapat digunakan untuk menentukan apakah alamat IP adalah alamat IPv6 Teredo dengan awalan 2001::/32.

Metode ini GetUnicastAddresses juga mengembalikan alamat non-Teredo dan menyediakan cara yang lebih nyaman untuk mendapatkan alamat IP unicast untuk sistem daripada menghitung semua System.Net.NetworkInformation.NetworkInterface objek di komputer lokal dan mengkueri alamat IP terkait.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh GetUnicastAddresses().

Lihat juga

• IsIPv6Teredo
• BeginGetUnicastAddresses(AsyncCallback, Object)
• EndGetUnicastAddresses(IAsyncResult)
• GetUnicastAddresses()