Dns.GetHostAddressesAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.NameResolution.dll

Overload

GetHostAddressesAsync(String, AddressFamily, CancellationToken)	Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan sebagai operasi asinkron.
GetHostAddressesAsync(String, CancellationToken)	Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan sebagai operasi asinkron.
GetHostAddressesAsync(String)	Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan sebagai operasi asinkron.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Sumber:

Dns.cs

Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan sebagai operasi asinkron.

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);

static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())

Parameter

hostNameOrAddress

String

Nama host atau alamat IP yang akan diatasi.

family

AddressFamily

Keluarga alamat tempat IP harus diambil. Jika Unspecified, ambil semua IP terlepas dari keluarga alamat.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

Task<IPAddress[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array jenis IPAddress yang menyimpan alamat IP untuk host yang ditentukan oleh hostNameOrAddress parameter .

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

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 GetHostAddresses(String, AddressFamily).

GetHostAddressesAsync(String, CancellationToken)

Sumber:

Dns.cs

Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan sebagai operasi asinkron.

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);

static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())

Parameter

hostNameOrAddress

String

Nama host atau alamat IP yang akan diatasi.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

Task<IPAddress[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array jenis IPAddress yang menyimpan alamat IP untuk host yang ditentukan oleh hostNameOrAddress parameter .

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

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 GetHostAddresses(String).

GetHostAddressesAsync(String)

Sumber:

Dns.cs

Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan sebagai operasi asinkron.

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress);

static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())

Parameter

hostNameOrAddress

String

Nama host atau alamat IP yang akan diatasi.

Mengembalikan

Task<IPAddress[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array jenis IPAddress yang menyimpan alamat IP untuk host yang ditentukan oleh hostNameOrAddress parameter .

Pengecualian

ArgumentNullException

hostNameOrAddressadalah null.

ArgumentOutOfRangeException

Panjangnya hostNameOrAddress lebih besar dari 255 karakter.

SocketException

Terjadi kesalahan saat menyelesaikan hostNameOrAddress.

ArgumentException

hostNameOrAddress adalah alamat IP yang tidak valid.

Keterangan

Operasi ini tidak akan memblokir. Objek yang hostNameOrAddress dikembalikan Task<TResult> akan selesai setelah diselesaikan.

Metode ini meminta server DNS untuk alamat IP yang terkait dengan nama host. Jika hostNameOrAddress adalah alamat IP, alamat ini dikembalikan tanpa mengkueri server DNS.

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 GetHostAddresses(String).