Dns.GetHostAddresses Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.NameResolution.dll

Overload

GetHostAddresses(String)	Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan.
GetHostAddresses(String, AddressFamily)	Mengembalikan alamat Protokol Internet (IP) untuk host yang ditentukan.

GetHostAddresses(String)

Sumber:

Dns.cs

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

public:
 static cli::array <System::Net::IPAddress ^> ^ GetHostAddresses(System::String ^ hostNameOrAddress);

public static System.Net.IPAddress[] GetHostAddresses (string hostNameOrAddress);

static member GetHostAddresses : string -> System.Net.IPAddress[]

Public Shared Function GetHostAddresses (hostNameOrAddress As String) As IPAddress()

Parameter

hostNameOrAddress

String

Nama host atau alamat IP yang akan diatasi.

Mengembalikan

IPAddress[]

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.

Contoh

Contoh kode berikut menggunakan GetHostAddresses metode untuk menyelesaikan alamat IP ke array jenis IPAddress.

    // Determine the Internet Protocol(IP) addresses for a host.
public:
    static void DoGetHostAddress(String^ hostname)
    {
        array<IPAddress^>^ addresses;
        addresses = Dns::GetHostAddresses(hostname);

        Console::WriteLine("GetHostAddresses({0}) returns:", hostname);
        for each (IPAddress^ address in addresses)
        {
            Console::Write("{0} ", address);
        }
        Console::WriteLine("");
   }

public static void DoGetHostAddresses(string hostname)
{
    IPAddress[] addresses = Dns.GetHostAddresses(hostname);

    Console.WriteLine($"GetHostAddresses({hostname}) returns:");

    foreach (IPAddress address in addresses)
    {
        Console.WriteLine($"    {address}");
    }
}

Public Sub DoGetHostAddresses(hostName As String)

    Dim addresses As IPAddress() = Dns.GetHostAddresses(hostname)

    Console.WriteLine($"GetHostAddresses({hostname}) returns:")

    Dim index As Integer
    For index = 0 To addresses.Length - 1
        Console.WriteLine($"    {addresses(index)}")
    Next index

End Sub

Keterangan

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

Jika string kosong diteruskan sebagai hostNameOrAddress argumen, maka metode ini mengembalikan alamat IPv4 dan IPv6 dari host lokal.

Alamat IPv6 difilter dari hasil GetHostAddresses metode jika komputer lokal tidak menginstal IPv6. Akibatnya, dimungkinkan untuk mendapatkan kembali instans kosong IPAddress jika hanya hasil IPv6 yang tersedia untuk hostNameOrAddress parameter .

Metode ini diimplementasikan menggunakan API resolusi nama sistem operasi yang mendasar (seperti getaddrinfo API Win32 di Windows, dan API yang setara pada platform lain). Jika host dijelaskan dalam hosts file, alamat IP atau alamat di sana akan 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.

GetHostAddresses(String, AddressFamily)

Sumber:

Dns.cs

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

public:
 static cli::array <System::Net::IPAddress ^> ^ GetHostAddresses(System::String ^ hostNameOrAddress, System::Net::Sockets::AddressFamily family);

public static System.Net.IPAddress[] GetHostAddresses (string hostNameOrAddress, System.Net.Sockets.AddressFamily family);

static member GetHostAddresses : string * System.Net.Sockets.AddressFamily -> System.Net.IPAddress[]

Public Shared Function GetHostAddresses (hostNameOrAddress As String, family As AddressFamily) As 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.

Mengembalikan

IPAddress[]

Array jenis IPAddress yang menyimpan alamat IP untuk host yang ditentukan oleh hostNameOrAddress parameter .