Dns.GetHostAddresses Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.NameResolution.dll

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

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

IPAddress[]

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

Výjimky

ArgumentNullException

hostNameOrAddress je null.

ArgumentOutOfRangeException

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

SocketException

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

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.

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

GetHostAddresses(String, AddressFamily)

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

IPAddress[]

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