GetHostByAddress Method (IPAddress)
Collapse the table of content
Expand the table of content

Dns::GetHostByAddress Method (IPAddress^)

 
Note: This API is now obsolete.

Creates an IPHostEntry instance from the specified IPAddress.

Namespace:   System.Net
Assembly:  System (in System.dll)

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

Parameters

address
Type: System.Net::IPAddress^

An IPAddress.

Return Value

Type: System.Net::IPHostEntry^

An IPHostEntry.

An IPHostEntry instance.

Exception Condition
ArgumentNullException

address is null.

SocketException

An error is encountered when resolving address.

System_CAPS_noteNote

This member emits trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework.

The following example creates a IPHostEntry from an IPAddress.

try
{
   IPAddress^ hostIPAddress = IPAddress::Parse( IpAddressString );
   IPHostEntry^ hostInfo = Dns::GetHostByAddress( hostIPAddress );

   // Get the IP address list that resolves to the host names contained in
   // the Alias property.
   array<IPAddress^>^address = hostInfo->AddressList;

   // Get the alias names of the addresses in the IP address list.
   array<String^>^alias = hostInfo->Aliases;
   Console::WriteLine( "Host name : {0}", 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 : {0}", e->Source );
   Console::WriteLine( "Message : {0}", e->Message );
}
catch ( FormatException^ e ) 
{
   Console::WriteLine( "FormatException caught!!!" );
   Console::WriteLine( "Source : {0}", e->Source );
   Console::WriteLine( "Message : {0}", e->Message );
}
catch ( ArgumentNullException^ e ) 
{
   Console::WriteLine( "ArgumentNullException caught!!!" );
   Console::WriteLine( "Source : {0}", e->Source );
   Console::WriteLine( "Message : {0}", e->Message );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Exception caught!!!" );
   Console::WriteLine( "Source : {0}", e->Source );
   Console::WriteLine( "Message : {0}", e->Message );
}

DnsPermission

for accessing DNS information. Associated enumeration: PermissionState::Unrestricted

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft