Dns.GetHostEntryAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci.
Přetížení
GetHostEntryAsync(IPAddress) |
Přeloží IP adresu na IPHostEntry instanci jako asynchronní operaci. |
GetHostEntryAsync(String) |
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci. |
GetHostEntryAsync(String, CancellationToken) |
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci. |
GetHostEntryAsync(String, AddressFamily, CancellationToken) |
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci. |
GetHostEntryAsync(IPAddress)
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
Přeloží IP adresu na IPHostEntry instanci jako asynchronní operaci.
public:
static System::Threading::Tasks::Task<System::Net::IPHostEntry ^> ^ GetHostEntryAsync(System::Net::IPAddress ^ address);
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync (System.Net.IPAddress address);
static member GetHostEntryAsync : System.Net.IPAddress -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (address As IPAddress) As Task(Of IPHostEntry)
Parametry
- address
- IPAddress
IP adresa.
Návraty
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí IPHostEntry instanci, která obsahuje informace o adrese hostitele zadaného v address
.
Výjimky
address
je null
.
Při řešení chyby dojde k address
chybě .
address
je neplatná IP adresa.
Poznámky
Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po vyřešení objektu address
.
Tato metoda se dotazuje serveru DNS na IP adresy a aliasy přidružené k IP adrese.
Adresy IPv6 jsou filtrovány z výsledků této metody, pokud místní počítač nemá nainstalovaný protokol IPv6. V důsledku toho je možné získat zpět prázdnou IPHostEntry instanci, pokud je pro address
parametr k dispozici pouze protokol IPv6.
Vlastnost AliasesIPHostEntry vrácené instance není touto metodou naplněna a bude vždy prázdná.
Poznámka
Tento člen generuje informace o trasování, když povolíte trasování sítě ve vaší aplikaci. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostEntry(IPAddress).
Platí pro
GetHostEntryAsync(String)
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci.
public:
static System::Threading::Tasks::Task<System::Net::IPHostEntry ^> ^ GetHostEntryAsync(System::String ^ hostNameOrAddress);
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync (string hostNameOrAddress);
static member GetHostEntryAsync : string -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (hostNameOrAddress As String) As Task(Of IPHostEntry)
Parametry
- hostNameOrAddress
- String
Název hostitele nebo IP adresa, které se mají přeložit.
Návraty
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí IPHostEntry instanci, která obsahuje informace o adrese hostitele zadaného v hostNameOrAddress
.
Výjimky
Parametr hostNameOrAddress
je null
.
Délka parametru hostNameOrAddress
je větší než 255 znaků.
Při překladu parametru došlo k hostNameOrAddress
chybě.
Parametr hostNameOrAddress
je neplatná IP adresa.
Poznámky
Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po vyřešení objektu hostNameOrAddress
.
Tato metoda se dotazuje serveru DNS na IP adresu přidruženou k názvu hostitele nebo IP adrese.
Pokud je jako hostNameOrAddress
argument předán prázdný řetězec, vrátí tato metoda adresy IPv4 a IPv6 místního hostitele.
Pokud se název hostitele nepodařilo najít, SocketException vrátí se výjimka s hodnotou 11001 (chyba rozhraní Windows Sockets WSAHOST_NOT_FOUND). Tato výjimka se může vrátit, pokud server DNS neodpoví. Tato výjimka může být vrácena také v případě, že název není oficiální název hostitele nebo alias nebo ho nelze najít v dotazovaných databázích.
Výjimka ArgumentException se vrátí také v případě, že hostNameOrAddress
parametr obsahuje Any nebo IPv6Any.
Tato metoda předpokládá, že pokud je v parametru předán hostNameOrAddress
řetězec literálu IP, aplikace chce IPHostEntry vrátit instanci se všemi nastavenými vlastnostmi. Mezi tyto vlastnosti patří AddressList, Aliasesa HostName. V důsledku toho implementace této metody vykazuje následující chování při předání řetězcového literálu IP:
Metoda se pokusí parsovat adresu.
hostNameOrAddress
Pokud parametr obsahuje literál řetězce IP, první fáze bude úspěšná.Zpětné vyhledávání s použitím IP adresy řetězcového literálu IP se pokusí získat název hostitele. Tento výsledek je nastaven jako HostName vlastnost .
Název hostitele z tohoto zpětného vyhledávání se znovu použije k získání všech možných IP adres přidružených k názvu a nastaví se jako AddressList vlastnost .
U řetězcového literálu IPv4 můžou být všechny tři výše uvedené kroky úspěšné. Je ale možné, že se vrátí zastaralý záznam DNS pro adresu IPv4, která ve skutečnosti patří k jinému hostiteli. To může způsobit selhání kroku 3 a vyvolá výjimku (existuje záznam DNS PTR pro adresu IPv4, ale žádný záznam DNS A pro adresu IPv4).
U protokolu IPv6 může krok 2 výše selhat, protože většina nasazení IPv6 neregistruje reverzní záznam (PTR) pro adresu IPv6. Tato metoda tedy může vrátit řetězcový literál IPv6 jako plně kvalifikovaný název hostitele domény (FQDN) ve HostName vlastnosti .
Metoda se GetHostAddresses s ohledem na literály PROTOKOLU IP chová jinak. Pokud krok 1 výše proběhne úspěšně (úspěšně se parsuje jako IP adresa), vrátí se tato adresa okamžitě jako výsledek. Neexistuje žádný pokus o zpětné vyhledávání.
Adresy IPv6 jsou filtrovány z výsledků této metody, pokud místní počítač nemá nainstalovaný protokol IPv6. V důsledku toho je možné získat zpět prázdnou IPHostEntry instanci, pokud je pro parametr k dispozici hostNameOrAddress
pouze protokol IPv6.
Vlastnost AliasesIPHostEntry vrácené instance není touto metodou naplněna a bude vždy prázdná.
Tato metoda se implementuje pomocí rozhraní API pro překlad názvů základního operačního systému (například win32 API getaddrinfo ve Windows a ekvivalentních rozhraní API na jiných platformách). Pokud je v hosts
souboru popsaný hostitel, vrátí se jeho IP adresa nebo adresy bez dotazování na server DNS.
Poznámka
Tento člen generuje informace o trasování, když povolíte trasování sítě ve vaší aplikaci. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostEntry(String).
Platí pro
GetHostEntryAsync(String, CancellationToken)
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci.
public:
static System::Threading::Tasks::Task<System::Net::IPHostEntry ^> ^ GetHostEntryAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);
static member GetHostEntryAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPHostEntry)
Parametry
- hostNameOrAddress
- String
Název hostitele nebo IP adresa, které se mají přeložit.
- cancellationToken
- CancellationToken
Token zrušení, který lze použít k signalizaci asynchronní operace, by měl být zrušen.
Návraty
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí IPHostEntry instanci, která obsahuje informace o adrese hostitele zadaného v hostNameOrAddress
.
Výjimky
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostEntry(String).
Platí pro
GetHostEntryAsync(String, AddressFamily, CancellationToken)
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
- Zdroj:
- Dns.cs
Přeloží název hostitele nebo IP adresu na IPHostEntry instanci jako asynchronní operaci.
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);
static member GetHostEntryAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPHostEntry)
Parametry
- hostNameOrAddress
- String
Název hostitele nebo IP adresa, které se mají přeložit.
- family
- AddressFamily
Řada adres, pro kterou se mají načíst IP adresy. Pokud , Unspecifiednačtěte všechny IP adresy bez ohledu na rodinu adres.
- cancellationToken
- CancellationToken
Token zrušení, který lze použít k signalizaci asynchronní operace, by měl být zrušen.
Návraty
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí IPHostEntry instanci, která obsahuje informace o adrese hostitele zadané v hostNameOrAddress
nástroji .
Výjimky
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostEntry(String, AddressFamily).
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro