IPAddress.Parse 方法

參考

定義

命名空間:: System.Net

組件:: System.dll, System.Net.Primitives.dll

組件:: System.Net.Primitives.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

Parse(String)	將 IP 位址字串轉換為 IPAddress 執行個體。
Parse(ReadOnlySpan<Char>)	將以字元範圍表示的 IP 位址轉換為 IPAddress 執行個體。

Parse(String)

來源:: IPAddress.cs

來源:: IPAddress.cs

來源:: IPAddress.cs

將 IP 位址字串轉換為 IPAddress 執行個體。

public:
 static System::Net::IPAddress ^ Parse(System::String ^ ipString);

public static System.Net.IPAddress Parse (string ipString);

static member Parse : string -> System.Net.IPAddress

Public Shared Function Parse (ipString As String) As IPAddress

參數

ipString: String

字串，包含使用 IPv4 點分隔四組數字標記法和 IPv6 冒號分隔十六進位標記法的 IP 位址。

傳回

IPAddress

IPAddress 執行個體。

例外狀況

ArgumentNullException

ipString 為 null。

FormatException

ipString 不是有效的 IP 位址。

範例

下列程式代碼會將包含IP位址的字串，在IPv4的點四次表示法中，或IPv6的冒號十六進位表示法轉換成類別的 IPAddress 實例。然後，它會使用多載 ToString 方法，以標準表示法顯示位址。

#using <System.dll>

using namespace System;
using namespace System::Net;

// This method calls the IPAddress::Parse method to check the ipAddress
// input string. If the ipAddress argument represents a syntatically correct IPv4 or
// IPv6 address, the method displays the Parse output into quad-notation or
// colon-hexadecimal notation, respectively. Otherwise, it displays an
// error message.
void parse( String^ ipAddress )
{
   try
   {
      
      // Create an instance of IPAddress for the specified address string (in
      // dotted-quad, or colon-hexadecimal notation).
      IPAddress^ address = IPAddress::Parse( ipAddress );
      
      // Display the address in standard notation.
      Console::WriteLine( "Parsing your input string: \"{0}\" produces this address (shown in its standard notation): {1}", ipAddress, address );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException caught!!!" );
      Console::WriteLine( "Source : {0}", e->Source );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( FormatException^ e ) 
   {
      Console::WriteLine( "FormatException 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 );
   }

}

int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   String^ IPaddress;
   if ( args->Length == 1 )
   {
      Console::WriteLine( "Please enter an IP address." );
      Console::WriteLine( "Usage:   >cs_parse any IPv4 or IPv6 address." );
      Console::WriteLine( "Example: >cs_parse 127.0.0.1" );
      Console::WriteLine( "Example: >cs_parse 0:0:0:0:0:0:0:1" );
      return 0;
   }
   else
      IPaddress = args[ 1 ];

   
   // Get the list of the IPv6 addresses associated with the requested host.
   parse( IPaddress );
}


using System;
using System.Net;

class ParseAddress
{

  private static void Main(string[] args)
  {
    string IPaddress;

    if (args.Length == 0)
    {
      Console.WriteLine("Please enter an IP address.");
      Console.WriteLine("Usage:   >cs_parse any IPv4 or IPv6 address.");
      Console.WriteLine("Example: >cs_parse 127.0.0.1");
      Console.WriteLine("Example: >cs_parse 0:0:0:0:0:0:0:1");
      return;
    }
    else
        {
            IPaddress = args[0];
        }

        // Get the list of the IPv6 addresses associated with the requested host.
        Parse(IPaddress);
  }

  // This method calls the IPAddress.Parse method to check the ipAddress
  // input string. If the ipAddress argument represents a syntatically correct IPv4 or
  // IPv6 address, the method displays the Parse output into quad-notation or
  // colon-hexadecimal notation, respectively. Otherwise, it displays an
  // error message.
  private static void Parse(string ipAddress)
  {
    try
    {
      // Create an instance of IPAddress for the specified address string (in
      // dotted-quad, or colon-hexadecimal notation).
      IPAddress address = IPAddress.Parse(ipAddress);

      // Display the address in standard notation.
      Console.WriteLine("Parsing your input string: " + "\"" + ipAddress + "\"" + " produces this address (shown in its standard notation): "+ address.ToString());
    }

    catch(ArgumentNullException e)
    {
      Console.WriteLine("ArgumentNullException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }

    catch(FormatException e)
    {
      Console.WriteLine("FormatException 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);
    }
   }
}

Imports System.Net



Class ParseAddress
   
   'Entry point which delegates to C-style main Private Function
   Public Overloads Shared Sub Main()
      Main(System.Environment.GetCommandLineArgs())
   End Sub
   
   
   Overloads Private Shared Sub Main(args() As String)
      Dim IPaddress As String
      
      If args.Length = 1 Then
         Console.WriteLine("Please enter an IP address.")
         Console.WriteLine("Usage:   >cs_parse any IPv4 or IPv6 address.")
         Console.WriteLine("Example: >cs_parse 127.0.0.1")
         Console.WriteLine("Example: >cs_parse 0:0:0:0:0:0:0:1")
         Return
      Else
         IPaddress = args(1)
      End If 
      ' Get the list of the IPv6 addresses associated with the requested host.
      Parse(IPaddress)
   End Sub
    
   
   ' This method calls the IPAddress.Parse method to check the ipAddress 
   ' input string. If the ipAddress argument represents a syntatical correct IPv4 or
   ' IPv6 address, the method displays the Parse output into quad-notation or
   ' colon-hexadecimal notation, respectively. Otherwise, it displays an 
   ' error message.
   Private Shared Sub Parse(ipAddr As String)
      Try
         ' Create an instance of IPAddress for the specified address string (in 
         ' dotted-quad, or colon-hexadecimal notation).
         Dim address As IPAddress = IPAddress.Parse(ipAddr)
         
         ' Display the address in standard notation.
         Console.WriteLine(("Parsing your input string: " + """" + ipAddr + """" + " produces this address (shown in its standard notation): " + address.ToString()))
      
      Catch e As ArgumentNullException
         Console.WriteLine("ArgumentNullException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      
      Catch e As FormatException
         Console.WriteLine("FormatException 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
End Class

備註

靜態 Parse 方法會 IPAddress 從以 IPv4 的點四方表示法表示法和 IPv6 的冒號十六進位表示法表示法來建立實例。

每個部分 (部分的數目會以句點分隔，) ipString 決定IP位址的建構方式。一個部分位址會直接儲存在網路位址中。兩個部分位址，方便指定類別 A 位址，會將前置部分放在第一個字節中，而尾端部分則放在網路位址最右邊的三個字節中。三部分位址，方便指定類別 B 位址、將第一個部分放在第一個字節、第二個字節的第二個部分，以及最右邊網路位址的兩個字節的最後一個部分。例如：

元件數目和範例 `ipString`	IPAddress 的 IPv4 位址
1 -- "65535"	0.0.255.255
2 -- "20.2"	20.0.0.2
2 -- "20.65535"	20.0.255.255
3 -- "128.1.2"	128.1.0.2
4 -- "1.1.1.10"	1.1.1.10
4 -- "1.1.1.010"	1.1.1.8
1 -- “0x2F”	0.0.0.47

適用於

Parse(ReadOnlySpan<Char>)

來源:: IPAddress.cs

來源:: IPAddress.cs

來源:: IPAddress.cs

將以字元範圍表示的 IP 位址轉換為 IPAddress 執行個體。

public:
 static System::Net::IPAddress ^ Parse(ReadOnlySpan<char> ipSpan);

public:
 static System::Net::IPAddress ^ Parse(ReadOnlySpan<char> ipString);

public static System.Net.IPAddress Parse (ReadOnlySpan<char> ipSpan);

public static System.Net.IPAddress Parse (ReadOnlySpan<char> ipString);

static member Parse : ReadOnlySpan<char> -> System.Net.IPAddress

static member Parse : ReadOnlySpan<char> -> System.Net.IPAddress

Public Shared Function Parse (ipSpan As ReadOnlySpan(Of Char)) As IPAddress

Public Shared Function Parse (ipString As ReadOnlySpan(Of Char)) As IPAddress

參數

ipStringipSpan: ReadOnlySpan<Char>

字元範圍，包含使用 IPv4 點分隔四組數字標記法和 IPv6 冒號分隔十六進位標記法的 IP 位址。

傳回

IPAddress

轉換的 IP 位址。

例外狀況

FormatException

ipString 不是有效的 IP 位址。

適用於

共用方式為

IPAddress.Parse 方法

定義

多載

Parse(String)

參數

傳回

例外狀況

範例

備註

適用於

Parse(ReadOnlySpan<Char>)

參數

傳回

例外狀況

適用於

其他資源