Dns.GetHostAddresses Yöntem

Tanım

Aşırı Yüklemeler

GetHostAddresses(String)

Belirtilen ana bilgisayar için İnternet Protokolü (IP) adreslerini döndürür.

GetHostAddresses(String, AddressFamily)

Belirtilen ana bilgisayar için İnternet Protokolü (IP) adreslerini döndürür.

GetHostAddresses(String)

Kaynak:
Dns.cs
Kaynak:
Dns.cs
Kaynak:
Dns.cs

Belirtilen ana bilgisayar için İnternet Protokolü (IP) adreslerini döndürür.

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

Parametreler

hostNameOrAddress
String

Çözümlenmesi gereken ana bilgisayar adı veya IP adresi.

Döndürülenler

parametresi tarafından belirtilen konağın IP adreslerini tutan tür IPAddress dizisi hostNameOrAddress .

Özel durumlar

hostNameOrAddress, null değeridir.

uzunluğu hostNameOrAddress 255 karakterden uzundur.

çözümlendiğinde hostNameOrAddressbir hatayla karşılaşıldı.

hostNameOrAddress geçersiz bir IP adresidir.

Örnekler

Aşağıdaki kod örneği, bir IP adresini türündeki IPAddressbir diziye çözümlemek için yöntemini kullanırGetHostAddresses.

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

Açıklamalar

yöntemi, GetHostAddresses bir ana bilgisayar adıyla ilişkili IP adresleri için DNS alt sistemini sorgular. BIR IP adresiyse hostNameOrAddress , bu adres DNS sunucusu sorgulanmadan döndürülür.

Bağımsız değişken olarak hostNameOrAddress boş bir dize geçirilirse, bu yöntem yerel konağın IPv4 ve IPv6 adreslerini döndürür.

Yerel bilgisayarda IPv6 yüklü değilse, IPv6 adresleri yöntemin sonuçlarından GetHostAddresses filtrelenir. Sonuç olarak, parametre için hostNameOrAddress yalnızca IPv6 sonuçları kullanılabiliyorsa boş IPAddress bir örneği geri almak mümkündür.

Bu yöntem, temel alınan işletim sisteminin ad çözümleme API'leri (Windows'da Win32 API getaddrinfo ve diğer platformlardaki eşdeğer API'ler gibi) kullanılarak uygulanır. Dosyada hosts bir konak açıklanmışsa, BURADAKI IP adresi veya adresler DNS sunucusu sorgulanmadan döndürülür.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini yayar. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Şunlara uygulanır

GetHostAddresses(String, AddressFamily)

Kaynak:
Dns.cs
Kaynak:
Dns.cs
Kaynak:
Dns.cs

Belirtilen ana bilgisayar için İnternet Protokolü (IP) adreslerini döndürür.

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

Parametreler

hostNameOrAddress
String

Çözümlenmesi gereken ana bilgisayar adı veya IP adresi.

family
AddressFamily

IP'lerin alınması gereken adres ailesi. ise Unspecified, adres ailesine bakılmaksızın tüm IP'leri alın.

Döndürülenler

parametresi tarafından belirtilen konağın IP adreslerini tutan tür IPAddress dizisi hostNameOrAddress .

Şunlara uygulanır