IPAddress.Parse Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.Primitives.dll

Перегрузки

Имя	Описание
Parse(ReadOnlySpan<Char>)	Преобразует IP-адрес, представленный как диапазон символов в IPAddress экземпляр.
Parse(String)	Преобразует строку IP-адреса в IPAddress экземпляр.
Parse(ReadOnlySpan<Byte>)	Анализирует диапазон символов UTF-8 в значение.

Parse(ReadOnlySpan<Char>)

Исходный код:

IPAddress.cs

Преобразует IP-адрес, представленный как диапазон символов в IPAddress экземпляр.

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

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

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

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

Параметры

ipSpan

ReadOnlySpan<Char>

Диапазон символов, содержащий IP-адрес в нотации dotted-quad для IPv4 и в шестнадцатеричной нотации двоеточия для IPv6.

Возвращаемое значение

IPAddress

Преобразованный IP-адрес.

Исключения

FormatException

ipString недопустимый IP-адрес.

Parse(String)

Исходный код:

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

Строка, содержащая IP-адрес в нотации dotted-quad для IPv4 и в шестнадцатеричной нотации двоеточия для IPv6.

Возвращаемое значение

IPAddress

Экземпляр IPAddress .

Исключения

ArgumentNullException

ipString равно null.

FormatException

ipString недопустимый IP-адрес.

Примеры

Следующий код преобразует строку, содержащую IP-адрес, в нотации dotted-quad для IPv4 или в шестнадцатеричной нотации двоеточия IPAddress для IPv6, в экземпляр класса. Затем он использует перегруженный 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);
    }
   }
}

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 метод создает экземпляр из IP-адреса, выраженного в нотации dotted-quad для IPv4 и в шестнадцатеричной нотации двоеточия для IPv6.

Количество частей (каждая часть разделена точкой) определяет ipString , как создается IP-адрес. Адрес одной части хранится непосредственно в сетевом адресе. Двухкомпонентный адрес, удобный для указания адреса класса A, помещает ведущую часть в первую байтовую и конечную часть в правой части сетевого адреса. Трехкомпонентный адрес, удобный для указания адреса класса B, помещает первую часть в первый байт, вторую часть во второй байт и последнюю часть в правой части сетевого адреса. Рассмотрим пример.

Количество частей и примеров ipString	IPv4-адрес для IPAddress
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<Byte>)

Исходный код:

IPAddress.cs

Анализирует диапазон символов UTF-8 в значение.

public:
 static System::Net::IPAddress ^ Parse(ReadOnlySpan<System::Byte> utf8Text);

public static System.Net.IPAddress Parse(ReadOnlySpan<byte> utf8Text);

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

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As IPAddress

Параметры

utf8Text

ReadOnlySpan<Byte>

Диапазон символов UTF-8 для анализа.

Возвращаемое значение

IPAddress

Результат синтаксического анализа utf8Text.