IPAddress Classe

Riferimento

Definizione

Spazio dei nomi:: System.Net

Assembly:: System.dll, System.Net.Primitives.dll

Assembly:: System.Net.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: IPAddress.cs

Source:: IPAddress.cs

Source:: IPAddress.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce un indirizzo IP (Internet Protocol).

public ref class IPAddress

public ref class IPAddress : IParsable<System::Net::IPAddress ^>, ISpanFormattable, ISpanParsable<System::Net::IPAddress ^>, IUtf8SpanFormattable

public class IPAddress

public class IPAddress : IParsable<System.Net.IPAddress>, ISpanFormattable, ISpanParsable<System.Net.IPAddress>, IUtf8SpanFormattable

[System.Serializable]
public class IPAddress

type IPAddress = class

type IPAddress = class
    interface ISpanFormattable
    interface IFormattable
    interface ISpanParsable<IPAddress>
    interface IParsable<IPAddress>
    interface IUtf8SpanFormattable

[<System.Serializable>]
type IPAddress = class

Public Class IPAddress

Public Class IPAddress
Implements IParsable(Of IPAddress), ISpanFormattable, ISpanParsable(Of IPAddress), IUtf8SpanFormattable

Ereditarietà: Object
IPAddress

Attributi: SerializableAttribute

Implementazioni: IFormattable IParsable<IPAddress> IParsable<TSelf> ISpanFormattable ISpanParsable<IPAddress> IUtf8SpanFormattable

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire query su un server per ottenere gli indirizzi della famiglia e gli indirizzi IP supportati.

// This program shows how to use the IPAddress class to obtain a server 
// IP addressess and related information.
#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::Sockets;
using namespace System::Text::RegularExpressions;

/**
* 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.
**/
void IPAddresses( String^ server )
{
   try
   {
      System::Text::ASCIIEncoding^ ASCII = gcnew System::Text::ASCIIEncoding;
      
      // Get server related information.
      IPHostEntry^ heserver = Dns::GetHostEntry( server );
      
      // Loop on the AddressList
      System::Collections::IEnumerator^ myEnum = heserver->AddressList->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         IPAddress^ curAdd = safe_cast<IPAddress^>(myEnum->Current);
         
         // Display the type of address family supported by the server. If the
         // server is IPv6-enabled this value is: InterNetworkV6. If the server
         // is also IPv4-enabled there will be an additional value of InterNetwork.
         Console::WriteLine( "AddressFamily: {0}", curAdd->AddressFamily );
         
         // Display the ScopeId property in case of IPV6 addresses.
         if ( curAdd->AddressFamily.ToString() == ProtocolFamily::InterNetworkV6.ToString() )
                  Console::WriteLine( "Scope Id: {0}", curAdd->ScopeId );

         // 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: {0}", curAdd );
         
         // Display the server IP address in byte format.
         Console::Write( "AddressBytes: " );
         
         array<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: {0}", e );
   }

}


// This IPAddressAdditionalInfo displays additional server address information.
void IPAddressAdditionalInfo()
{
   try
   {
      // Display the flags that show if the server supports IPv4 or IPv6
      // address schemas.
      Console::WriteLine( "\r\nSupportsIPv4: {0}", Socket::SupportsIPv4 );
      Console::WriteLine( "SupportsIPv6: {0}", 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: {0}", IPAddress::IPv6Any );

         // Display the server loopback address. 
         Console::WriteLine( "IPv6Loopback: {0}", IPAddress::IPv6Loopback );

         // Used during autoconfiguration first phase.
         Console::WriteLine( "IPv6None: {0}", IPAddress::IPv6None );
         Console::WriteLine( "IsLoopback(IPv6Loopback): {0}", IPAddress::IsLoopback( IPAddress::IPv6Loopback ) );
      }
      Console::WriteLine( "IsLoopback(Loopback): {0}", IPAddress::IsLoopback( IPAddress::Loopback ) );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "[IPAddresses] Exception: {0}", e );
   }

}

int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   String^ server = nullptr;

   // 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 = gcnew Regex( "^[a-zA-Z]\\w{1,39}$" );
   if ( args->Length < 2 )
   {
      // 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: {0}", server );
   }
   else
   {
      server = args[ 1 ];
      if (  !(rex->Match(server))->Success )
      {
         Console::WriteLine( "Input string format not allowed." );
         return  -1;
      }
   }

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

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


// 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: InterNetworkV6. 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 additional address information.
      IPAddressAdditionalInfo();
    }
  }
}

' This program shows how to use the IPAddress class to obtain a server 
' IP addressess and related information.
Imports System.Net
Imports System.Net.Sockets
Imports System.Text.RegularExpressions

Namespace Mssc.Services.ConnectionManagement
  Module M_TestIPAddress

    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 Shared Sub IPAddresses(ByVal server As String)
        Try
          Dim ASCII As New System.Text.ASCIIEncoding()

          ' Get server related information.
          Dim heserver As IPHostEntry = Dns.Resolve(server)

          ' Loop on the AddressList
          Dim curAdd As IPAddress
          For Each curAdd In heserver.AddressList

            ' Display the type of address family supported by the server. If the
            ' server is IPv6-enabled this value is: InterNetworkV6. 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() Then
              Console.WriteLine(("Scope Id: " + curAdd.ScopeId.ToString()))
            End If

            ' 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: ")



            Dim bytes As [Byte]() = curAdd.GetAddressBytes()
            Dim i As Integer
            For i = 0 To bytes.Length - 1
              Console.Write(bytes(i))
            Next i
            Console.WriteLine(ControlChars.Cr + ControlChars.Lf)
          Next curAdd 

        Catch e As Exception
          Console.WriteLine(("[DoResolve] Exception: " + e.ToString()))
        End Try
      End Sub


      ' This IPAddressAdditionalInfo displays additional server address information.
      Private Shared Sub IPAddressAdditionalInfo()
        Try
          ' Display the flags that show if the server supports IPv4 or IPv6
          ' address schemas.
          Console.WriteLine((ControlChars.Cr + ControlChars.Lf + "SupportsIPv4: " + Socket.SupportsIPv4.ToString()))
          Console.WriteLine(("SupportsIPv6: " + Socket.SupportsIPv6.ToString()))

          If Socket.SupportsIPv6 Then
            ' Display the server Any address. This IP address indicates that the server 
            ' should listen for client activity on all network interfaces. 
            Console.WriteLine((ControlChars.Cr + ControlChars.Lf + "IPv6Any: " + 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).ToString()))
          End If
          Console.WriteLine(("IsLoopback(Loopback): " + IPAddress.IsLoopback(IPAddress.Loopback).ToString()))
        Catch e As Exception
          Console.WriteLine(("[IPAddresses] Exception: " + e.ToString()))
        End Try
      End Sub

      Public Shared Sub Main(ByVal args() As String)
        Dim server As String = Nothing

        ' 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.
        Dim rex As New Regex("^[a-zA-Z]\w{1,39}$")

        If args.Length < 1 Then
          ' 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 Not rex.Match(server).Success Then
            Console.WriteLine("Input string format not allowed.")
            Return
          End If
        End If

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

        ' Get additional address information.
        IPAddressAdditionalInfo()
      End Sub
    End Class
  End Module
End Namespace

Commenti

La IPAddress classe contiene l'indirizzo di un computer in una rete IP.

Costruttori

IPAddress(Byte[])	Inizializza una nuova istanza della classe IPAddress con l'indirizzo specificato come matrice Byte.
IPAddress(Byte[], Int64)	Inizializza una nuova istanza della classe IPAddress con l'indirizzo specificato come matrice Byte e l'identificatore di ambito specificato.
IPAddress(Int64)	Inizializza una nuova istanza della classe IPAddress con l'indirizzo specificato struttura Int64.
IPAddress(ReadOnlySpan<Byte>)	Inizializza una nuova istanza della classe IPAddress con l'indirizzo specificato come intervallo di byte.
IPAddress(ReadOnlySpan<Byte>, Int64)	Inizializza una nuova istanza della classe IPAddress con l'indirizzo specificato come intervallo di byte e l'identificatore di ambito specificato.

Campi

Any	Fornisce un indirizzo IP che indica che il server deve attendere l'attività dei client su tutte le interfacce di rete. Questo campo è di sola lettura.
Broadcast	Fornisce l'indirizzo di broadcast IP. Questo campo è di sola lettura.
IPv6Any	Il metodo Bind(EndPoint) utilizza il campo IPv6Any per indicare che una classe Socket deve attendere l'attività dei client su tutte le interfacce di rete.
IPv6Loopback	Fornisce l'indirizzo di loopback IP. Questa proprietà è di sola lettura.
IPv6None	Fornisce un indirizzo IP che indica che non deve essere utilizzata alcuna interfaccia di rete. Questa proprietà è di sola lettura.
Loopback	Fornisce l'indirizzo di loopback IP. Questo campo è di sola lettura.
None	Fornisce un indirizzo IP che indica che non deve essere utilizzata alcuna interfaccia di rete. Questo campo è di sola lettura.

Proprietà

Address	Obsoleti. Obsoleti. Obsoleti. Obsoleti. Obsoleti. Indirizzo IP (Internet Protocol).
AddressFamily	Ottiene la famiglia di indirizzi dell'indirizzo IP.
IsIPv4MappedToIPv6	Ottiene se l'indirizzo IP è di tipo IPv6 mappato IPv4.
IsIPv6LinkLocal	Ottiene se l'indirizzo è di tipo link-local IPv6.
IsIPv6Multicast	Ottiene se l'indirizzo è di tipo multicast globale IPv6.
IsIPv6SiteLocal	Ottiene se l'indirizzo è di tipo site-local IPv6.
IsIPv6Teredo	Ottiene un valore che indica se l'indirizzo è di tipo Teredo IPv6.
IsIPv6UniqueLocal	Ottiene se l'indirizzo è un indirizzo locale univoco IPv6.
ScopeId	Ottiene o imposta l'identificatore di ambito dell'indirizzo IPv6.

Metodi

Equals(Object)	Confronta due indirizzi IP.
GetAddressBytes()	Fornisce una copia dell'oggetto come matrice di byte nell'ordine IPAddress di rete.
GetHashCode()	Restituisce un valore hash per un indirizzo IP.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HostToNetworkOrder(Int16)	Converte un valore short dall'ordine dei byte dell'host a quello della rete.
HostToNetworkOrder(Int32)	Converte un valore intero dall'ordine dei byte dell'host a quello della rete.
HostToNetworkOrder(Int64)	Converte un valore long dall'ordine dei byte dell'host a quello della rete.
IsLoopback(IPAddress)	Indica se l'indirizzo IP specificato è quello di loopback.
MapToIPv4()	Esegue il mapping dell'oggetto IPAddress a un indirizzo IPv4.
MapToIPv6()	Esegue il mapping dell'oggetto IPAddress a un indirizzo IPv6.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
NetworkToHostOrder(Int16)	Converte un valore short dall'ordine dei byte della rete a quello dell'host.
NetworkToHostOrder(Int32)	Converte un valore intero dall'ordine dei byte della rete a quello dell'host.
NetworkToHostOrder(Int64)	Converte un valore long dall'ordine dei byte della rete a quello dell'host.
Parse(ReadOnlySpan<Char>)	Converte un indirizzo IP rappresentato come intervallo di caratteri in un'istanza di IPAddress.
Parse(String)	Converte una stringa di indirizzi IP in un'istanza di IPAddress.
ToString()	Converte un indirizzo Internet nella relativa notazione standard.
TryFormat(Span<Byte>, Int32)	Tenta di formattare l'indirizzo IP corrente nell'intervallo specificato.
TryFormat(Span<Char>, Int32)	Tenta di formattare l'indirizzo IP corrente nell'intervallo specificato.
TryParse(ReadOnlySpan<Char>, IPAddress)	Prova a analizzare un intervallo di caratteri in un valore.
TryParse(String, IPAddress)	Determina se una stringa è un indirizzo IP valido.
TryWriteBytes(Span<Byte>, Int32)	Tenta di scrivere l'indirizzo IP corrente in un intervallo di byte nell'ordine di rete.

Implementazioni dell'interfaccia esplicita

IFormattable.ToString(String, IFormatProvider)	Formatta il valore dell'istanza corrente usando il formato specificato.
IParsable<IPAddress>.Parse(String, IFormatProvider)	Analizza una stringa in un valore.
IParsable<IPAddress>.TryParse(String, IFormatProvider, IPAddress)	Prova a analizzare una stringa in un IPAddressoggetto .
ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tenta di formattare il valore dell'istanza corrente nell'intervallo specificato di caratteri.
ISpanParsable<IPAddress>.Parse(ReadOnlySpan<Char>, IFormatProvider)	Analizza un intervallo di caratteri in un valore.
ISpanParsable<IPAddress>.TryParse(ReadOnlySpan<Char>, IFormatProvider, IPAddress)	Prova a analizzare un intervallo di caratteri in un valore.
IUtf8SpanFormattable.TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Prova a formattare il valore dell'istanza corrente come UTF-8 nell'intervallo specificato di byte.

Si applica a