Экспорт (0) Печать
Развернуть все
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала

Dns.GetHostByName - метод

Примечание. Данный 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
Тип: System.String
DNS-имя узла.

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

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

ИсключениеУсловие
ArgumentNullException

Параметр hostName имеет значение null.

ArgumentOutOfRangeException

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

SocketException

При разрешении hostName возникает ошибка.

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

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

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

ПримечаниеПримечание

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

В следующем примере показано применение метода 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);
	  }


.NET Framework

Поддерживается в версиях: 1.1, 1.0
Устарело (предупреждение компилятора) в 4.5
Устарело (предупреждение компилятора) в 4
Устарело (предупреждение компилятора) в 3.5
Устарело (предупреждение компилятора) в 3.5 с пакетом обновления 1 (SP1)
Устарело (предупреждение компилятора) в 3.0
Устарело (предупреждение компилятора) в 3.0 с пакетом обновления 1 (SP1)
Устарело (предупреждение компилятора) в 3.0 с пакетом обновления 2 (SP2)
Устарело (предупреждение компилятора) в 2.0
Устарело (предупреждение компилятора) в 2.0 с пакетом обновления 1 (SP1)
Устарело (предупреждение компилятора) в 2.0 с пакетом обновления 2 (SP2)

.NET Framework (клиентский профиль)

Устарело (предупреждение компилятора) в 4
Устарело (предупреждение компилятора) в 3.5 с пакетом обновления 1 (SP1)

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

Среда .NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Добавления сообщества

ДОБАВИТЬ
Показ:
© 2014 Microsoft