Sdílet prostřednictvím


Dns.GetHostAddresses Metoda

Definice

Přetížení

GetHostAddresses(String)

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

GetHostAddresses(String, AddressFamily)

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

GetHostAddresses(String)

Zdroj:
Dns.cs
Zdroj:
Dns.cs
Zdroj:
Dns.cs

Vrátí IP adresy pro 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

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

Výjimky

hostNameOrAddress je null.

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

Při řešení chyby dojde k hostNameOrAddresschybě .

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.

    // 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

Poznámky

Metoda GetHostAddresses se dotazuje podsysté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 dotazu na server DNS.

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

Adresy IPv6 jsou filtrovány z výsledků GetHostAddresses metody, pokud místní počítač nemá nainstalovaný protokol IPv6. V důsledku toho je možné získat zpět 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 ip adres příslušné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 v hosts souboru popsaný hostitel, ip adresa nebo adresy tam budou vráceny bez dotazování serveru DNS.

Poznámka

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

Platí pro

GetHostAddresses(String, AddressFamily)

Zdroj:
Dns.cs
Zdroj:
Dns.cs
Zdroj:
Dns.cs

Vrátí IP adresy pro 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

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

Návraty

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

Platí pro