Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Secara asinkron mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan.
public:
static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, object? state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback requestCallback, object state);
static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult
Parameter
- hostNameOrAddress
- String
Nama host atau alamat IP untuk diselesaikan.
- requestCallback
- AsyncCallback
Delegasi AsyncCallback yang mereferensikan metode untuk dipanggil saat operasi selesai.
- state
- Object
Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke requestCallback
delegasi ketika operasi selesai.
Mengembalikan
Instans IAsyncResult yang mereferensikan permintaan asinkron.
Pengecualian
hostNameOrAddress
adalah null
.
Panjangnya hostNameOrAddress
lebih besar dari 255 karakter.
Terjadi kesalahan saat menyelesaikan hostNameOrAddress
.
hostNameOrAddress
adalah alamat IP yang tidak valid.
Keterangan
Metode ini BeginGetHostAddresses secara asinkron meminta server DNS untuk alamat IP yang terkait dengan nama host. Jika hostNameOrAddress
adalah alamat IP, alamat ini dikembalikan tanpa mengkueri server DNS.
Catatan
Anggota ini memancarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Jika string kosong diteruskan sebagai hostNameOrAddress
argumen, maka metode ini mengembalikan alamat IPv4 dan IPv6 dari host lokal.
Operasi asinkron BeginGetHostAddresses harus diselesaikan dengan memanggil EndGetHostAddresses metode . Biasanya, metode ini dipanggil oleh requestCallback
delegasi.
Metode ini tidak memblokir sampai operasi selesai. Untuk memblokir hingga operasi selesai, gunakan GetHostAddresses metode .
Untuk informasi selengkapnya tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron