Dns.GetHostEntryAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir ana bilgisayar adını veya IP adresini IPHostEntry bir örneğe zaman uyumsuz işlem olarak çözümler.
Aşırı Yüklemeler
GetHostEntryAsync(IPAddress) |
Ip adresini bir örneğe IPHostEntry zaman uyumsuz bir işlem olarak çözümler. |
GetHostEntryAsync(String) |
Bir konak adını veya IP adresini bir örneğe IPHostEntry zaman uyumsuz bir işlem olarak çözümler. |
GetHostEntryAsync(String, CancellationToken) |
Bir konak adını veya IP adresini bir örneğe IPHostEntry zaman uyumsuz bir işlem olarak çözümler. |
GetHostEntryAsync(String, AddressFamily, CancellationToken) |
Bir konak adını veya IP adresini bir örneğe IPHostEntry zaman uyumsuz bir işlem olarak çözümler. |
GetHostEntryAsync(IPAddress)
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
Ip adresini bir örneğe 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
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde address
belirtilen konak hakkında adres bilgilerini içeren bir IPHostEntry örnek döndürür.
Özel durumlar
address
, null
değeridir.
çözümlendiğinde address
bir hatayla karşılaşıldı.
address
geçersiz bir IP adresidir.
Açıklamalar
Bu işlem engellemez. 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.
Döndürülen Aliases örneğin özelliği IPHostEntry bu yöntemle doldurulmuyor ve her zaman boş olacak.
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.
Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetHostEntry(IPAddress)özel durumlara bakın.
Şunlara uygulanır
GetHostEntryAsync(String)
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
Bir konak adını veya IP adresini bir örneğe IPHostEntry zaman uyumsuz bir işlem olarak çö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
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde hostNameOrAddress
belirtilen konak hakkında adres bilgilerini içeren bir IPHostEntry örnek döndürür.
Özel durumlar
hostNameOrAddress
parametresidirnull
.
Parametrenin hostNameOrAddress
uzunluğu 255 karakterden büyük.
Parametresi çözümlendiğinde bir hatayla hostNameOrAddress
karşılaşıldı.
hostNameOrAddress
Parametresi geçersiz bir IP adresi.
Açıklamalar
Bu işlem engellemez. döndürülen Task<TResult> nesne çözümlendikten sonra hostNameOrAddress
tamamlanır.
Bu yöntem, bir ana bilgisayar adı veya IP adresiyle ilişkili 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ülünü istediğini varsayar. Bu özellikler , Aliasesve HostNameözelliklerini içerirAddressList. Sonuç olarak, bir IP dizesi değişmez değeri geçirildiğinde bu yöntemin uygulanması aşağıdaki davranışı sergiler:
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.Ana bilgisayar adı elde etmek için IP dizesi değişmez değerinin IP adresini kullanan bir geriye doğru arama denendi. Bu sonuç özelliği olarak HostName ayarlanır.
Bu geriye doğru 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 ana bilgisayara ait olan bir IPv4 adresi için eski bir DNS kaydının döndürülmesini sağlamak mümkündür. Bu, 3. adımın başarısız olmasına ve özel durum oluşturmasına neden olabilir (IPv4 adresi için bir DNS PTR kaydı vardır, ancak IPv4 adresi için DNS A kaydı yoktur).
Çoğu IPv6 dağıtımı bir 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, IPv6 değişmez değerini özelliğinde HostName tam etki alanı (FQDN) ana bilgisayar adı olarak döndürebilir.
yöntemi IP GetHostAddresses değişmez değerlerine göre farklı davranışlara sahiptir. Yukarıdaki 1. adım başarılı olursa (ip adresi olarak başarıyla 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 hostNameOrAddress
kullanılabilir olduğunda yalnızca IPv6 sonuçları varsa boş IPHostEntry bir örneği geri almak mümkündür.
Döndürülen Aliases örneğin özelliği IPHostEntry bu yöntemle 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, 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.
Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetHostEntry(String)özel durumlara bakın.
Şunlara uygulanır
GetHostEntryAsync(String, CancellationToken)
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
Bir konak adını veya IP adresini bir örneğe IPHostEntry zaman uyumsuz bir işlem olarak çö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 sinyalini vermek için kullanılabilecek bir iptal belirteci iptal edilmelidir.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde hostNameOrAddress
belirtilen konak hakkında adres bilgilerini içeren bir IPHostEntry örnek döndürür.
Özel durumlar
İ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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetHostEntry(String)özel durumlara bakın.
Şunlara uygulanır
GetHostEntryAsync(String, AddressFamily, CancellationToken)
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
- Kaynak:
- Dns.cs
Bir ana bilgisayar adını veya IP adresini IPHostEntry bir örneğe zaman uyumsuz işlem olarak çö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 ailesine bakılmaksızın tüm IP'leri alın.
- cancellationToken
- CancellationToken
Zaman uyumsuz işlemin sinyalini vermek için kullanılabilecek bir iptal belirteci iptal edilmelidir.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, içinde hostNameOrAddress
belirtilen konakla ilgili adres bilgilerini içeren bir IPHostEntry örnek döndürür.
Özel durumlar
İ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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetHostEntry(String, AddressFamily)özel durumlara bakın.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin