Dns.GetHostEntryAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.NameResolution.dll

Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.

Aşırı Yüklemeler

Name	Description
GetHostEntryAsync(IPAddress)	Bir örneğin IP adresini IPHostEntry zaman uyumsuz bir işlem olarak çözümler.
GetHostEntryAsync(String)	Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.
GetHostEntryAsync(String, CancellationToken)	Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.
GetHostEntryAsync(String, AddressFamily, CancellationToken)	Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.

GetHostEntryAsync(IPAddress)

Kaynak:

Dns.cs

Bir örneğin IP adresini IPHostEntry zaman uyumsuz bir işlem olarak çözümler.

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)

Parametreler

address

IPAddress

Bir IP adresi.

Döndürülenler

Task<IPHostEntry>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde addressbelirtilen konak hakkında adres bilgilerini içeren bir IPHostEntry örnek döndürür.

Özel durumlar

ArgumentNullException

address, null'e eşittir.

SocketException

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

ArgumentException

address geçersiz bir IP adresidir.

Açıklamalar

Bu işlem engellenmez. Döndürülen Task<TResult> nesne çözümlendikten sonra address tamamlanır.

Bu yöntem, bir IP adresiyle ilişkili IP adresleri ve diğer adlar için bir DNS sunucusunu sorgular.

Yerel bilgisayarda IPv6 yüklü değilse, IPv6 adresleri bu yöntemin sonuçlarından filtrelenir. Sonuç olarak, parametre için address kullanılabilir olduğunda yalnızca IPv6 sonuçları varsa boş IPHostEntry bir örneği geri almak mümkündür.

Aliases Döndürülen örneğin özelliği IPHostEntry bu yöntem tarafından doldurulmuyor ve her zaman boş olacak.

Uyarı

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini yayar. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından GetHostEntry(IPAddress)oluşan özel durumlara bakın.

GetHostEntryAsync(String)

Kaynak:

Dns.cs

Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.

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)

Parametreler

hostNameOrAddress

String

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

Döndürülenler

Task<IPHostEntry>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde hostNameOrAddressbelirtilen konak hakkında adres bilgilerini içeren bir IPHostEntry örnek döndürür.

Özel durumlar

ArgumentNullException

hostNameOrAddress parametresi null'dir.

ArgumentOutOfRangeException

Parametrenin hostNameOrAddress uzunluğu 255 karakterden büyük.

SocketException

Parametresi çözümlendiğinde hostNameOrAddress bir hatayla karşılaşıldı.

ArgumentException

hostNameOrAddress parametresi geçersiz bir IP adresidir.

Açıklamalar

Bu işlem engellenmez. Döndürülen Task<TResult> nesne çözümlendikten sonra hostNameOrAddress tamamlanır.

Bu yöntem, bir ana bilgisayar adı veya IP adresiyle ilişkilendirilmiş IP adresi için bir DNS sunucusunu sorgular.

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.

Ana bilgisayar adı bulunamazsa, SocketException özel durum 11001 değeriyle döndürülür (Windows Yuvaları hatası WSAHOST_NOT_FOUND). DNS sunucusu yanıt vermezse bu özel durum döndürülebilir. Bu özel durum, ad resmi bir ana bilgisayar adı veya diğer ad değilse veya sorgulanan veritabanlarında bulunamıyorsa da döndürülebilir.

ArgumentException Parametresi veya IPv6Anyiçeriyorsa Any özel durum da döndürülürhostNameOrAddress.

Bu yöntem, parametresinde hostNameOrAddress bir IP değişmez değeri dizesi geçirilirse uygulamanın tüm özellikleri ayarlanmış bir IPHostEntry örneğin döndürülmesini istediğini varsayar. Bu özellikler arasında AddressList, Aliasesve HostNamebulunur. Sonuç olarak, bir IP dizesi değişmez değeri geçirildiğinde bu yöntemin uygulanması aşağıdaki davranışı sergiler:

1. yöntemi adresi ayrıştırmaya çalışır. Parametresi yasal hostNameOrAddress bir IP dizesi değişmez değeri içeriyorsa, ilk aşama başarılı olur.

2. Ana bilgisayar adını almak için IP dizesi değişmez değerinin IP adresini kullanan bir ters arama denendi. Bu sonuç özelliği olarak HostName ayarlanır.

3. Bu ters aramadaki ana bilgisayar adı, adla ilişkili tüm olası IP adreslerini almak ve özellik olarak AddressList ayarlamak için yeniden kullanılır.

IPv4 dize değişmez değeri için yukarıdaki üç adımın tümü başarılı olabilir. Ancak, aslında farklı bir konağa ait olan bir IPv4 adresi için eski bir DNS kaydının döndürülebilir. Bu, 3. adımın başarısız olmasına ve özel durum oluşturmasına neden olabilir (IPv4 adresi için DNS PTR kaydı vardır, ancak IPv4 adresi için DNS A kaydı yoktur).

IPv6 dağıtımlarının çoğu IPv6 adresi için ters (PTR) kaydını kaydetmediğinden IPv6 için yukarıdaki 2. adım başarısız olabilir. Bu nedenle bu yöntem, özelliğinde tam etki alanı (FQDN) ana bilgisayar adı olarak IPv6 değişmez değeri dizesini HostName döndürebilir.

yöntemi, GetHostAddresses IP değişmez değerlerine göre farklı davranışlara sahiptir. Yukarıdaki 1. adım başarılı olursa (başarıyla IP adresi olarak ayrıştırılır), sonuç olarak bu adres hemen döndürülür. Geriye doğru arama girişimi yoktur.

Yerel bilgisayarda IPv6 yüklü değilse, IPv6 adresleri bu yöntemin sonuçlarından filtrelenir. Sonuç olarak, .parameter için hostNameOrAddresskullanılabilir olduğunda yalnızca IPv6 sonuçları varsa boş IPHostEntry bir örneği geri almak mümkündür.

Aliases Döndürülen örneğin özelliği IPHostEntry bu yöntem tarafından doldurulmuyor ve her zaman boş olacak.

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, DNS sunucusu sorgulanmadan ip adresi veya adresleri döndürülür.

Uyarı

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini yayar. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından GetHostEntry(String)oluşan özel durumlara bakın.

GetHostEntryAsync(String, CancellationToken)

Kaynak:

Dns.cs

Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.

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)

Parametreler

hostNameOrAddress

String

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

cancellationToken

CancellationToken

Zaman uyumsuz işlemin iptal edilmesi gerektiğini belirten bir iptal belirteci.

Döndürülenler

Task<IPHostEntry>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde hostNameOrAddressbelirtilen konakla ilgili adres bilgilerini içeren bir IPHostEntry örnek döndürür.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından GetHostEntry(String)oluşan özel durumlara bakın.

GetHostEntryAsync(String, AddressFamily, CancellationToken)

Kaynak:

Dns.cs

Bir konak adını veya IP adresini IPHostEntry zaman uyumsuz bir işlem olarak bir örneğe çözümler.

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)

Parametreler

hostNameOrAddress

String

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

family

AddressFamily

IP'lerin alınması gereken adres ailesi. ise Unspecified, adres ailesinden bağımsız olarak tüm IP'leri alır.

cancellationToken

CancellationToken

Zaman uyumsuz işlemin iptal edilmesi gerektiğini belirten bir iptal belirteci.

Döndürülenler

Task<IPHostEntry>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde hostNameOrAddressbelirtilen konakla ilgili adres bilgilerini içeren bir IPHostEntry örnek döndürür.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından GetHostEntry(String, AddressFamily)oluşan özel durumlara bakın.