Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

IPAddress-Klasse

 

Veröffentlicht: Oktober 2016

Stellt eine Internetprotokolladresse (IP) bereit.

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

System.Object
  System.Net.IPAddress

[SerializableAttribute]
public class IPAddress

NameBeschreibung
System_CAPS_pubmethodIPAddress(Byte[])

Initialisiert eine neue Instanz von der IPAddress -Klasse mit der Adresse als ein Byte Array.

System_CAPS_pubmethodIPAddress(Byte[], Int64)

Initialisiert eine neue Instanz von der IPAddress -Klasse mit der Adresse als ein Byte Array zusammen mit dem angegebenen Bereich.

System_CAPS_pubmethodIPAddress(Int64)

Initialisiert eine neue Instanz von der IPAddress -Klasse mit der Adresse als ein Int64.

NameBeschreibung
System_CAPS_pubpropertyAddress

Veraltet. Eine Internetprotokoll (IP)-Adresse.

System_CAPS_pubpropertyAddressFamily

Ruft die Adressfamilie der IP-Adresse ab.

System_CAPS_pubpropertyIsIPv4MappedToIPv6

Ruft ab, ob die IP-Adresse eine IPv4-zugeordneten IPv6-Adresse ist.

System_CAPS_pubpropertyIsIPv6LinkLocal

Ruft ab, ob die Adresse eine IPv6 Link-local-Adresse ist.

System_CAPS_pubpropertyIsIPv6Multicast

Ruft ab, ob die Adresse eine IPv6 globale Multicastadresse.

System_CAPS_pubpropertyIsIPv6SiteLocal

Ruft ab, ob die Adresse eine IPv6-Site-local-Adresse ist.

System_CAPS_pubpropertyIsIPv6Teredo

Ruft ab, ob die Adresse eine IPv6-Teredo-Adresse ist.

System_CAPS_pubpropertyScopeId

Ruft ab oder legt den Bezeichner für den Gültigkeitsbereich der IPv6-Adresse.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Vergleicht zwei IP-Adressen.(Überschreibt Object.Equals(Object).)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.(Geerbt von „Object“.)

System_CAPS_pubmethodGetAddressBytes()

Enthält eine Kopie der IPAddress als Array von Bytes.

System_CAPS_pubmethodGetHashCode()

Gibt einen Hashwert für eine IP-Adresse zurück.(Überschreibt Object.GetHashCode().)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodSystem_CAPS_staticHostToNetworkOrder(Int16)

Konvertiert einen short-Wert aus der Host-Bytereihenfolge in die Netzwerk-Bytereihenfolge.

System_CAPS_pubmethodSystem_CAPS_staticHostToNetworkOrder(Int32)

Konvertiert einen ganzzahligen Wert aus der Host-Bytereihenfolge in die Netzwerk-Bytereihenfolge.

System_CAPS_pubmethodSystem_CAPS_staticHostToNetworkOrder(Int64)

Konvertiert einen long-Wert aus der Host-Bytereihenfolge in die Netzwerk-Bytereihenfolge.

System_CAPS_pubmethodSystem_CAPS_staticIsLoopback(IPAddress)

Gibt an, ob die angegebene IP-Adresse um die Loopback-Adresse ist.

System_CAPS_pubmethodMapToIPv4()

Ordnet das IPAddress-Objekt einer IPv4-Adresse zu.

System_CAPS_pubmethodMapToIPv6()

Ordnet die IPAddress -Objekt, eine IPv6-Adresse.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodSystem_CAPS_staticNetworkToHostOrder(Int16)

Konvertiert einen short-Wert aus der Netzwerk-Bytereihenfolge in die Host-Bytereihenfolge.

System_CAPS_pubmethodSystem_CAPS_staticNetworkToHostOrder(Int32)

Konvertiert einen ganzzahligen Wert aus der Netzwerk-Bytereihenfolge in die Host-Bytereihenfolge.

System_CAPS_pubmethodSystem_CAPS_staticNetworkToHostOrder(Int64)

Konvertiert einen long-Wert aus der Netzwerk-Bytereihenfolge in die Host-Bytereihenfolge.

System_CAPS_pubmethodSystem_CAPS_staticParse(String)

Konvertiert eine IP-Adresszeichenfolge in eine IPAddress Instanz.

System_CAPS_pubmethodToString()

Eine IP-Adresse konvertiert in der Standardschreibweise.(Überschreibt Object.ToString().)

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, IPAddress)

Ermittelt, ob eine Zeichenfolge eine gültige IP-Adresse ist.

NameBeschreibung
System_CAPS_pubfieldSystem_CAPS_staticAny

Stellt eine IP-Adresse, die angibt, dass der Server die Clientaktivität an allen Netzwerkschnittstellen überwachen soll. Dieses Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticBroadcast

Die IP-broadcast-Adresse bereitgestellt. Dieses Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticIPv6Any

Die Socket.Bind -Methode verwendet die IPv6Any Feld an, dass eine Socket muss Clientaktivität an allen Netzwerkschnittstellen.

System_CAPS_pubfieldSystem_CAPS_staticIPv6Loopback

Enthält die IP-Loopbackadresse. Diese Eigenschaft ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticIPv6None

Stellt eine IP-Adresse, die angibt, dass keine Netzwerkschnittstelle verwendet werden soll. Diese Eigenschaft ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticLoopback

Enthält die IP-Loopbackadresse. Dieses Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticNone

Stellt eine IP-Adresse, die angibt, dass keine Netzwerkschnittstelle verwendet werden soll. Dieses Feld ist schreibgeschützt.

Die IPAddress -Klasse enthält die Adresse eines Computers in einem IP-Netzwerk.

Im folgenden Codebeispiel wird veranschaulicht, wie einen Server zum Abrufen der Familien Adressen Abfragen und die IP-Adressen unterstützt.


// This program shows how to use the IPAddress class to obtain a server 
// IP addressess and related information.

using System;
using System.Net;
using System.Net.Sockets;
using System.Text.RegularExpressions;

namespace Mssc.Services.ConnectionManagement
{

  class TestIPAddress 
  {

    /**
      * The IPAddresses method obtains the selected server IP address information.
      * It then displays the type of address family supported by the server and its 
      * IP address in standard and byte format.
      **/
    private static void IPAddresses(string server) 
    {
      try 
      {
        System.Text.ASCIIEncoding ASCII = new System.Text.ASCIIEncoding();

        // Get server related information.
        IPHostEntry heserver = Dns.GetHostEntry(server);

        // Loop on the AddressList
        foreach (IPAddress curAdd in heserver.AddressList) 
        {


          // Display the type of address family supported by the server. If the
          // server is IPv6-enabled this value is: InternNetworkV6. If the server
          // is also IPv4-enabled there will be an additional value of InterNetwork.
          Console.WriteLine("AddressFamily: " + curAdd.AddressFamily.ToString());

          // Display the ScopeId property in case of IPV6 addresses.
          if(curAdd.AddressFamily.ToString() == ProtocolFamily.InterNetworkV6.ToString())
            Console.WriteLine("Scope Id: " + curAdd.ScopeId.ToString());


          // Display the server IP address in the standard format. In 
          // IPv4 the format will be dotted-quad notation, in IPv6 it will be
          // in in colon-hexadecimal notation.
          Console.WriteLine("Address: " + curAdd.ToString());

          // Display the server IP address in byte format.
          Console.Write("AddressBytes: ");



          Byte[] bytes = curAdd.GetAddressBytes();
          for (int i = 0; i < bytes.Length; i++) 
          {
            Console.Write(bytes[i]);
          }                          

          Console.WriteLine("\r\n");

        }

      }
      catch (Exception e) 
      {
        Console.WriteLine("[DoResolve] Exception: " + e.ToString());
      }
    }

    // This IPAddressAdditionalInfo displays additional server address information.
    private static void IPAddressAdditionalInfo() 
    {
      try 
      {
        // Display the flags that show if the server supports IPv4 or IPv6
        // address schemas.
        Console.WriteLine("\r\nSupportsIPv4: " + Socket.SupportsIPv4);
        Console.WriteLine("SupportsIPv6: " + Socket.SupportsIPv6);

        if (Socket.SupportsIPv6)
        {
          // Display the server Any address. This IP address indicates that the server 
          // should listen for client activity on all network interfaces. 
          Console.WriteLine("\r\nIPv6Any: " + IPAddress.IPv6Any.ToString());

          // Display the server loopback address. 
          Console.WriteLine("IPv6Loopback: " + IPAddress.IPv6Loopback.ToString());

          // Used during autoconfiguration first phase.
          Console.WriteLine("IPv6None: " + IPAddress.IPv6None.ToString());

          Console.WriteLine("IsLoopback(IPv6Loopback): " + IPAddress.IsLoopback(IPAddress.IPv6Loopback));
        }
        Console.WriteLine("IsLoopback(Loopback): " + IPAddress.IsLoopback(IPAddress.Loopback));
      }
      catch (Exception e) 
      {
        Console.WriteLine("[IPAddresses] Exception: " + e.ToString());
      }
    }


    public static void Main(string[] args) 
    {
      string server = null;

      // Define a regular expression to parse user's input.
      // This is a security check. It allows only
      // alphanumeric input string between 2 to 40 character long.
      Regex rex = new Regex(@"^[a-zA-Z]\w{1,39}$");

      if (args.Length < 1)
      {
        // If no server name is passed as an argument to this program, use the current 
        // server name as default.
        server = Dns.GetHostName();
        Console.WriteLine("Using current host: " + server);
      }
      else
      {
        server = args[0];
        if (!(rex.Match(server)).Success)
        {
          Console.WriteLine("Input string format not allowed.");
          return;
        }
      }

      // Get the list of the addresses associated with the requested server.
      IPAddresses(server);

      // Get additonal address information.
      IPAddressAdditionalInfo();
    }

  }
}

Universelle Windows-Plattform
Verfügbar seit 10
.NET Framework
Verfügbar seit 1.1
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: