Dns.GetHostAddresses Metod

Definition

Namnområde:
System.Net
Sammansättningar:
netstandard.dll, System.Net.NameResolution.dll
Sammansättning:
System.Net.NameResolution.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Överlagringar

Name Description
GetHostAddresses(String)

Returnerar IP-adresserna (Internet Protocol) för den angivna värden.
GetHostAddresses(String, AddressFamily)

Returnerar IP-adresserna (Internet Protocol) för den angivna värden.

GetHostAddresses(String)

Källa:
Dns.cs
Källa:
Dns.cs
Källa:
Dns.cs
Källa:
Dns.cs
Källa:
Dns.cs

Returnerar IP-adresserna (Internet Protocol) för den angivna värden.

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

Parametrar

hostNameOrAddress
String

Värdnamnet eller IP-adressen som ska matchas.

Returer

IPAddress[]

En matris av typen IPAddress som innehåller IP-adresserna för värden som anges av parametern hostNameOrAddress .

Undantag

ArgumentNullException

hostNameOrAddress är null.

ArgumentOutOfRangeException

Längden hostNameOrAddress på är större än 255 tecken.

SocketException

Ett fel påträffas när du löser hostNameOrAddress.

ArgumentException

hostNameOrAddress är en ogiltig IP-adress.

Exempel

I följande kodexempel används GetHostAddresses metoden för att matcha en IP-adress till en matris av typen 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

Kommentarer

Metoden GetHostAddresses frågar DNS-undersystemet efter DE IP-adresser som är associerade med ett värdnamn. Om hostNameOrAddress är en IP-adress returneras den här adressen utan att fråga DNS-servern.

Om en tom sträng skickas som hostNameOrAddress argument returnerar den här metoden IPv4- och IPv6-adresserna för den lokala värden.

IPv6-adresser filtreras från resultatet av GetHostAddresses metoden om den lokala datorn inte har IPv6 installerat. Därför är det möjligt att få tillbaka en tom IPAddress instans om endast IPv6-resultat var tillgängliga för parametern hostNameOrAddress .

Den här metoden implementeras med hjälp av det underliggande operativsystemets namnmatchnings-API:er (till exempel Win32 API getaddrinfo på Windows och motsvarande API:er på andra plattformar). Om en värd beskrivs i hosts filen returneras IP-adressen eller adresserna där utan att fråga DNS-servern.

Note

Den här medlemmen genererar spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Gäller för

GetHostAddresses(String, AddressFamily)

Källa:
Dns.cs
Källa:
Dns.cs
Källa:
Dns.cs
Källa:
Dns.cs
Källa:
Dns.cs

Returnerar IP-adresserna (Internet Protocol) för den angivna värden.

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

Parametrar

hostNameOrAddress
String

Värdnamnet eller IP-adressen som ska matchas.

family
AddressFamily

Adressfamiljen som IP-adresser ska hämtas för. Om Unspecifiedhämtar du alla IP-adresser oavsett adressfamilj.

Returer

IPAddress[]

En matris av typen IPAddress som innehåller IP-adresserna för värden som anges av parametern hostNameOrAddress .

Gäller för