Dns.GetHostAddresses Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.NameResolution.dll

Přetížení

Name	Description
GetHostAddresses(String)	Vrátí IP adresy protokolu IP zadaného hostitele.
GetHostAddresses(String, AddressFamily)	Vrátí IP adresy protokolu IP zadaného hostitele.

GetHostAddresses(String)

Zdroj:

Dns.cs

Vrátí IP adresy protokolu IP zadaného hostitele.

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

Název hostitele nebo IP adresa, které se mají přeložit.

Návraty

IPAddress[]

Pole typu IPAddress , které obsahuje IP adresy hostitele určeného parametrem hostNameOrAddress .

Výjimky

ArgumentNullException

hostNameOrAddress je null.

ArgumentOutOfRangeException

Délka hostNameOrAddress je větší než 255 znaků.

SocketException

Při řešení hostNameOrAddressdošlo k chybě .

ArgumentException

hostNameOrAddress je neplatná IP adresa.

Příklady

Následující příklad kódu používá metodu GetHostAddresses k překladu IP adresy na pole typu IPAddress.

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

Poznámky

Metoda GetHostAddresses se dotazuje subsystému DNS na IP adresy přidružené k názvu hostitele. Pokud hostNameOrAddress se jedná o IP adresu, vrátí se tato adresa bez dotazování na server DNS.

Pokud se jako argument předá hostNameOrAddress prázdný řetězec, vrátí tato metoda adresy IPv4 a IPv6 místního hostitele.

Adresy IPv6 se filtrují z výsledků GetHostAddresses metody, pokud místní počítač nemá nainstalovaný protokol IPv6. V důsledku toho je možné vrátit prázdnou IPAddress instanci, pokud byly pro hostNameOrAddress parametr k dispozici pouze výsledky IPv6.

Tato metoda se implementuje pomocí rozhraní API pro překlad názvů základního operačního systému (například rozhraní API Win32 getaddrinfo ve Windows a ekvivalentních rozhraní API na jiných platformách). Pokud je hostitel popsaný v hosts souboru, vrátí se IP adresa nebo adresy bez dotazování na server DNS.

Note

Tento člen generuje informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

GetHostAddresses(String, AddressFamily)

Zdroj:

Dns.cs

Vrátí IP adresy protokolu IP zadaného hostitele.

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

Název hostitele nebo IP adresa, které se mají přeložit.

family

AddressFamily

Řada adres, pro kterou se mají načíst IP adresy. Pokud Unspecifiednačtěte všechny IP adresy bez ohledu na rodinu adres.

Návraty

IPAddress[]

Pole typu IPAddress , které obsahuje IP adresy hostitele určeného parametrem hostNameOrAddress .