Dns.GetHostAddresses Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.NameResolution.dll

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

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

IPAddress[]

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

Özel durumlar

ArgumentNullException

hostNameOrAddress, null değeridir.

ArgumentOutOfRangeException

uzunluğu hostNameOrAddress 255 karakterden uzundur.

SocketException

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

ArgumentException

hostNameOrAddress geçersiz bir IP adresidir.

Örnekler

Aşağıdaki kod örneği, 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 ana bilgisayar adıyla ilişkilendirilmiş 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, parametresi 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, ORADAKI IP adresi veya adresleri 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 bkz. .NET Framework'te Ağ İzleme.

GetHostAddresses(String, AddressFamily)

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

IPAddress[]

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