Dns.GetHostAddresses Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.NameResolution.dll

Przeciążenia

GetHostAddresses(String)	Zwraca adresy protokołu internetowego (IP) dla określonego hosta.
GetHostAddresses(String, AddressFamily)	Zwraca adresy protokołu internetowego (IP) dla określonego hosta.

GetHostAddresses(String)

Źródło:

Dns.cs

Zwraca adresy protokołu internetowego (IP) dla określonego hosta.

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()

Parametry

hostNameOrAddress

String

Nazwa hosta lub adres IP do rozpoznania.

Zwraca

IPAddress[]

Tablica typu IPAddress , która zawiera adresy IP hosta określonego hostNameOrAddress przez parametr .

Wyjątki

ArgumentNullException

hostNameOrAddress to null.

ArgumentOutOfRangeException

Długość hostNameOrAddress jest większa niż 255 znaków.

SocketException

Napotkano błąd podczas rozwiązywania problemu hostNameOrAddress.

ArgumentException

hostNameOrAddress jest nieprawidłowym adresem IP.

Przykłady

W poniższym przykładzie kodu użyto GetHostAddresses metody , aby rozpoznać adres IP w tablicy typu 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

Uwagi

Metoda GetHostAddresses wysyła zapytanie do podsystemu DNS dla adresów IP skojarzonych z nazwą hosta. Jeśli hostNameOrAddress jest to adres IP, ten adres jest zwracany bez wykonywania zapytań dotyczących serwera DNS.

Jeśli pusty ciąg jest przekazywany jako hostNameOrAddress argument, ta metoda zwraca adresy IPv4 i IPv6 hosta lokalnego.

Adresy IPv6 są filtrowane na podstawie wyników metody, jeśli komputer lokalny nie ma zainstalowanego GetHostAddresses protokołu IPv6. W związku z tym można odzyskać puste IPAddress wystąpienie, jeśli tylko wyniki protokołu IPv6 były dostępne dla parametru hostNameOrAddress .

Ta metoda jest implementowana przy użyciu podstawowych interfejsów API rozpoznawania nazw systemu operacyjnego (takich jak getaddrinfo interfejsu API Win32 w systemie Windows i równoważnych interfejsów API na innych platformach). Jeśli host jest opisany w hosts pliku, adres IP lub adresy zostaną zwrócone bez wykonywania zapytań dotyczących serwera DNS.

Uwaga

Ten element członkowski emituje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

GetHostAddresses(String, AddressFamily)

Źródło:

Dns.cs

Zwraca adresy protokołu internetowego (IP) dla określonego hosta.

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()

Parametry

hostNameOrAddress

String

Nazwa hosta lub adres IP do rozpoznania.

family

AddressFamily

Rodzina adresów, dla której należy pobrać adresy IP. Jeśli Unspecified, pobierz wszystkie adresy IP niezależnie od rodziny adresów.

Zwraca

IPAddress[]

Tablica typu IPAddress , która zawiera adresy IP hosta określonego hostNameOrAddress przez parametr .