IPHostEntry.HostName Property

Definition

Namespace:

System.Net

Assembly:

System.Net.NameResolution.dll

Source:

IPHostEntry.cs

Gets or sets the DNS name of the host.

public:
 property System::String ^ HostName { System::String ^ get(); void set(System::String ^ value); };

public string HostName { get; set; }

member this.HostName : string with get, set

Public Property HostName As String

Property Value

String

A string that contains the primary host name for the server.

Examples

The following example uses the HostName property to retrieve the primary host name.

void GetIpAddressList( String^ hostString )
{
   try
   {
      // Get 'IPHostEntry' object containing information
      // like host name, IP addresses, aliases for a host.
      IPHostEntry^ hostInfo = Dns::GetHostByName( hostString );
      Console::WriteLine( "Host name : {0}", hostInfo->HostName );
      Console::WriteLine( "IP address List : " );
      for ( int index = 0; index < hostInfo->AddressList->Length; index++ )
         Console::WriteLine( hostInfo->AddressList[ index ] );
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "SocketException 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 );
   }
}

public void GetIpAddressList(String hostString)
{
    try
    {
        // Get 'IPHostEntry' object containing information like host name, IP addresses, aliases for a host.
        IPHostEntry hostInfo = Dns.GetHostByName(hostString);
        Console.WriteLine("Host name : " + hostInfo.HostName);
        Console.WriteLine("IP address List : ");
        for(int index=0; index < hostInfo.AddressList.Length; index++)
        {
            Console.WriteLine(hostInfo.AddressList[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);
    }
}

Public Sub GetIpAddressList(hostString As [String])
    Try
        ' Get 'IPHostEntry' object which contains information like host name, IP addresses, aliases
    ' for specified url
        Dim hostInfo As IPHostEntry = Dns.GetHostByName(hostString)
        Console.WriteLine(("Host name : " + hostInfo.HostName))
        Console.WriteLine("IP address List : ")
        Dim index As Integer
        For index = 0 To hostInfo.AddressList.Length - 1
            Console.WriteLine(hostInfo.AddressList(index))
        Next index
    Catch e As SocketException
        Console.WriteLine("SocketException caught!!!")
        Console.WriteLine(("Source : " + e.Source))
        Console.WriteLine(("Message : " + e.Message))
    Catch e As ArgumentNullException
        Console.WriteLine("ArgumentNullException caught!!!")
        Console.WriteLine(("Source : " + e.Source))
        Console.WriteLine(("Message : " + e.Message))
    Catch e As Exception
        Console.WriteLine("Exception caught!!!")
        Console.WriteLine(("Source : " + e.Source))
        Console.WriteLine(("Message : " + e.Message))
    End Try
End Sub

Remarks

The HostName property contains the primary host name for a server. If the DNS entry for the server defines additional aliases, they will be available in the Aliases property.