IPHostEntry.HostName-Eigenschaft

Ruft den DNS-Namen des Hosts ab oder legt diesen fest.

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

Syntax

'Declaration
Public Property HostName As String
'Usage
Dim instance As IPHostEntry
Dim value As String

value = instance.HostName

instance.HostName = value

public string HostName { get; set; }

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

/** @property */
public String get_HostName ()

/** @property */
public void set_HostName (String value)

public function get HostName () : String

public function set HostName (value : String)

Eigenschaftenwert

Eine Zeichenfolge mit dem primären Hostnamen für den Server.

Hinweise

Die HostName-Eigenschaft enthält den primären Hostnamen für einen Server. Wenn der DNS-Eintrag für den Server weitere Aliase definiert, sind diese in der Aliases-Eigenschaft verfügbar.

Beispiel

Im folgenden Beispiel wird die HostName-Eigenschaft zum Abrufen des primären Hostnamens verwendet.

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 'GetIpAddressList

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);
    }
}

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.get_HostName());
            Console.WriteLine("IP address List : ");
            for (int index = 0; index < hostInfo.get_AddressList().
                length; index++) {
                Console.WriteLine(hostInfo.get_AddressList().get_Item(index));
            }
        }
        catch (SocketException e) {
            Console.WriteLine("SocketException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (ArgumentNullException e) {
            Console.WriteLine("ArgumentNullException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
    } //GetIpAddressList
} //HostInfoSample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IPHostEntry-Klasse
IPHostEntry-Member
System.Net-Namespace