Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Метод Dns.GetHostByName (String)

 

Опубликовано: Октябрь 2016

Примечание. Этот API устарел.

Возвращает сведения DNS для указанного DNS-имени узла.

Пространство имен:   System.Net
Сборка:  System (в System.dll)

[ObsoleteAttribute("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public static IPHostEntry GetHostByName(
	string hostName
)

Параметры

hostName
Type: System.String

DNS-имя узла.

Возвращаемое значение

Type: System.Net.IPHostEntry

IPHostEntry Объект, содержащий сведения об узле для адреса, указанного в hostName.

Exception Condition
ArgumentNullException

Свойство hostName имеет значение null.

ArgumentOutOfRangeException

Длина hostName превышает 255 символов.

SocketException

Ошибка при разрешении hostName.

GetHostByName Метод запрашивает у сервера DNS Интернета сведения об узле. Если передается пустая строка имени узла, этот метод получает стандартное имя узла локального компьютера.

Для асинхронного доступа к сведениям DNS используйте BeginGetHostByName и EndGetHostByName методы.

Если Ipv6Element.Enabled свойству true, Aliases Свойства IPHostEntry экземпляр, возвращаемый этим методом не заполняется и всегда будет пустым.

System_CAPS_noteПримечание

Этот член генерирует сведения трассировки, если в приложении включена трассировка сети. Для получения дополнительной информации см. Трассировка сети в .NET Framework.

В следующем примере используется GetHostByName метод для получения сведений DNS для указанного DNS-имени узла.

    try 
    {
       IPHostEntry hostInfo = Dns.GetHostByName(hostName);
       // Get the IP address list that resolves to the host names contained in the 
       // Alias property.
       IPAddress[] address = hostInfo.AddressList;
       // Get the alias names of the addresses in the IP address list.
       String[] alias = hostInfo.Aliases;

       Console.WriteLine("Host name : " + hostInfo.HostName);
       Console.WriteLine("\nAliases : ");
       for(int index=0; index < alias.Length; index++) {
         Console.WriteLine(alias[index]);
       } 
       Console.WriteLine("\nIP address list : ");
       for(int index=0; index < address.Length; index++) {
          Console.WriteLine(address[index]);
       }
    }
    catch(SocketException e) 
    {
       Console.WriteLine("SocketException caught!!!");
       Console.WriteLine("Source : " + e.Source);
       Console.WriteLine("Message : " + e.Message);
    }
    catch(ArgumentNullException e)
    {
Console.WriteLine("ArgumentNullException caught!!!");
       Console.WriteLine("Source : " + e.Source);
       Console.WriteLine("Message : " + e.Message);
    }
 catch(Exception e)
 {
  Console.WriteLine("Exception caught!!!");
  Console.WriteLine("Source : " + e.Source);
  Console.WriteLine("Message : " + e.Message);
 }

DnsPermission

for accessing DNS information. Associated enumeration: F:System.Security.Permissions.PermissionState.Unrestricted

.NET Framework
Доступно с 1.1
Вернуться в начало
Показ: