IPAddress.Parse 方法

定義

多載

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 (string ipString);

參數

ipString
String

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

傳回

IPAddress 執行個體。

例外狀況

ipStringnull

ipString 不是有效的 IP 位址。

範例

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


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

備註

靜態 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

適用於

.NET 9 及其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

參數

ipStringipSpan
ReadOnlySpan<Char>

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

傳回

轉換的 IP 位址。

例外狀況

ipString 不是有效的 IP 位址。

適用於

.NET 9 及其他版本
產品 版本
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1