IPAddress Kelas

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Primitives.dll

Sumber:

IPAddress.cs

Menyediakan alamat Protokol Internet (IP).

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

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

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

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

Warisan

Object

IPAddress

Penerapan

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

Contoh

Contoh kode berikut menunjukkan cara mengkueri server untuk mendapatkan alamat keluarga dan alamat IP yang didukungnya.

// 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

Keterangan

Kelas IPAddress berisi alamat komputer pada jaringan IP.

Konstruktor

IPAddress(Byte[])	Menginisialisasi instans IPAddress baru kelas dengan alamat yang ditentukan sebagai Byte array.
IPAddress(Byte[], Int64)	Menginisialisasi instans IPAddress baru kelas dengan alamat yang ditentukan sebagai Byte array dan pengidentifikasi cakupan yang ditentukan.
IPAddress(Int64)	Menginisialisasi instans IPAddress baru kelas dengan alamat yang ditentukan sebagai Int64.
IPAddress(ReadOnlySpan<Byte>)	Menginisialisasi instans IPAddress baru kelas dengan alamat yang ditentukan sebagai rentang byte.
IPAddress(ReadOnlySpan<Byte>, Int64)	Menginisialisasi instans IPAddress baru kelas dengan alamat yang ditentukan sebagai rentang byte dan pengidentifikasi cakupan yang ditentukan.

Bidang

Any	Menyediakan alamat IP yang menunjukkan bahwa server harus mendengarkan aktivitas klien di semua antarmuka jaringan. Bidang ini hanya-baca.
Broadcast	Menyediakan alamat siaran IP. Bidang ini hanya-baca.
IPv6Any	Metode ini Bind(EndPoint) menggunakan IPv6Any bidang untuk menunjukkan bahwa Socket harus mendengarkan aktivitas klien di semua antarmuka jaringan.
IPv6Loopback	Menyediakan alamat loopback IP. Properti ini bersifat hanya baca.
IPv6None	Menyediakan alamat IP yang menunjukkan bahwa tidak ada antarmuka jaringan yang harus digunakan. Properti ini bersifat hanya baca.
Loopback	Menyediakan alamat loopback IP. Bidang ini hanya-baca.
None	Menyediakan alamat IP yang menunjukkan bahwa tidak ada antarmuka jaringan yang harus digunakan. Bidang ini hanya-baca.

Properti

Address	Kedaluwarsa. Alamat Protokol Internet (IP).
AddressFamily	Mendapatkan keluarga alamat alamat IP.
IsIPv4MappedToIPv6	Mendapatkan apakah alamat IP adalah alamat IPv6 yang dipetakan IPv4.
IsIPv6LinkLocal	Mendapatkan apakah alamat tersebut adalah alamat lokal tautan IPv6.
IsIPv6Multicast	Mendapatkan apakah alamat tersebut adalah alamat global multicast IPv6.
IsIPv6SiteLocal	Mendapatkan apakah alamat tersebut adalah alamat lokal situs IPv6.
IsIPv6Teredo	Mendapatkan apakah alamat tersebut adalah alamat Teredo IPv6.
IsIPv6UniqueLocal	Mendapatkan apakah alamat tersebut adalah alamat Lokal Unik IPv6.
ScopeId	Mendapatkan atau mengatur pengidentifikasi cakupan alamat IPv6.

Metode

Equals(Object)	Membandingkan dua alamat IP.
GetAddressBytes()	Menyediakan salinan IPAddress sebagai array byte dalam urutan jaringan.
GetHashCode()	Mengembalikan nilai hash untuk alamat IP.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
HostToNetworkOrder(Int16)	Mengonversi nilai pendek dari urutan byte host ke urutan byte jaringan.
HostToNetworkOrder(Int32)	Mengonversi nilai bilangan bulat dari urutan byte host ke urutan byte jaringan.
HostToNetworkOrder(Int64)	Mengonversi nilai panjang dari urutan byte host ke urutan byte jaringan.
IsLoopback(IPAddress)	Menunjukkan apakah alamat IP yang ditentukan adalah alamat loopback.
MapToIPv4()	Memetakan objek ke IPAddress alamat IPv4.
MapToIPv6()	Memetakan objek ke IPAddress alamat IPv6.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
NetworkToHostOrder(Int16)	Mengonversi nilai singkat dari urutan byte jaringan ke urutan byte host.
NetworkToHostOrder(Int32)	Mengonversi nilai bilangan bulat dari urutan byte jaringan menjadi urutan byte host.
NetworkToHostOrder(Int64)	Mengonversi nilai panjang dari urutan byte jaringan menjadi urutan byte host.
Parse(ReadOnlySpan<Char>)	Mengonversi alamat IP yang direpresentasikan sebagai rentang karakter menjadi IPAddress instans.
Parse(String)	Mengonversi string alamat IP menjadi IPAddress instans.
ToString()	Mengonversi alamat Internet ke notasi standarnya.
TryFormat(Span<Byte>, Int32)	Mencoba memformat alamat IP saat ini ke dalam rentang yang disediakan.
TryFormat(Span<Char>, Int32)	Mencoba memformat alamat IP saat ini ke dalam rentang yang disediakan.
TryParse(ReadOnlySpan<Char>, IPAddress)	Mencoba mengurai rentang karakter ke dalam nilai.
TryParse(String, IPAddress)	Menentukan apakah string adalah alamat IP yang valid.
TryWriteBytes(Span<Byte>, Int32)	Mencoba menulis alamat IP saat ini ke dalam rentang byte dalam urutan jaringan.

Implementasi Antarmuka Eksplisit

IFormattable.ToString(String, IFormatProvider)	Memformat nilai instans saat ini menggunakan format yang ditentukan.
IParsable<IPAddress>.Parse(String, IFormatProvider)	Mengurai string menjadi nilai.
IParsable<IPAddress>.TryParse(String, IFormatProvider, IPAddress)	Mencoba mengurai string ke dalam IPAddress.
ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Mencoba memformat nilai instans saat ini ke dalam rentang karakter yang disediakan.
ISpanParsable<IPAddress>.Parse(ReadOnlySpan<Char>, IFormatProvider)	Mengurai rentang karakter ke dalam nilai.
ISpanParsable<IPAddress>.TryParse(ReadOnlySpan<Char>, IFormatProvider, IPAddress)	Mencoba mengurai rentang karakter ke dalam nilai.
IUtf8SpanFormattable.TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Mencoba memformat nilai instans saat ini sebagai UTF-8 ke dalam rentang byte yang disediakan.