IPEndPoint.Parse Метод

Определение

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

System.Net

Сборка:

System.Net.Primitives.dll

Перегрузки

Parse(ReadOnlySpan<Char>)	Преобразует конечную точку IP-сети (адрес и порт), представленную в виде диапазона, доступного только для чтения, в экземпляр IPEndPoint.
Parse(String)	Преобразует конечную точку IP-сети (адрес и порт), представленную в виде строки, в экземпляр IPEndPoint.

Комментарии

Количество частей (каждая часть разделена точкой) в s определяет способ создания IP-адреса конечной точки. Однокомпонентный адрес хранится непосредственно в сетевом адресе. Адрес из двух частей, удобный для указания адреса класса A, помещает передовую часть в первый байт, а завершающую часть — в наиболее правые три байта сетевого адреса. Адрес из трех частей, удобный для указания адреса класса B, помещает первую часть в первый байт, вторую часть во второй байт, а заключительную часть — в самые правые два байта сетевого адреса. Пример:

Число частей и пример s	IPv4-адрес для IPEndPoint.Address	Port
1 -- "1"	0.0.0.1	0
2 -- "20.2:80"	20.0.0.2	80
2 -- "20.65535:23"	20.0.255.255	23
3 -- "128.1.2:443"	128.1.0.2	443

Важно!

Обратите внимание, что этот метод принимает как допустимое значение, которое можно проанализировать как Int64, а затем обрабатывает его Int64 как длинное значение IP-адреса в сетевом порядке байтов, аналогично тому, как это делает конструктор IPAddress. Это означает, что этот метод возвращает значение true, если int64 успешно проанализирован, даже если он представляет адрес, который не является допустимым IP-адресом. Например, если s имеет значение "1", этот метод возвращает значение true, даже если "1" (или 0.0.0.1) не является допустимым IP-адресом, и этот метод может возвращать значение false. Исправление этой ошибки приведет к прерыванию работы существующих приложений, поэтому текущее поведение не изменится. Ваш код может избежать такого поведения, убедив, что он использует этот метод только для анализа IP-адресов в формате пунктирной дроби.

Литеральные IPv6-адреса должны быть заключены в квадратные скобки [] при передаче конечной точки, указывающей номер порта; В противном случае квадратные скобки не являются обязательными.

Parse(ReadOnlySpan<Char>)

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

IPEndPoint.cs

Преобразует конечную точку IP-сети (адрес и порт), представленную в виде диапазона, доступного только для чтения, в экземпляр IPEndPoint.

public:
 static System::Net::IPEndPoint ^ Parse(ReadOnlySpan<char> s);

public static System.Net.IPEndPoint Parse (ReadOnlySpan<char> s);

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

Public Shared Function Parse (s As ReadOnlySpan(Of Char)) As IPEndPoint

Параметры

s

ReadOnlySpan<Char>

Диапазон с доступом только для чтения, содержащий конечную точку IP, выраженную в виде четырех чисел, разделенных точками, или в сетевом байтовом формате в случае протокола IPv4 и в системе записи "двоеточие-шестнадцатиричное число" в случае протокола IPv6.

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

IPEndPoint

Объектное представление конечной точки IP-сети.

Исключения

ArgumentNullException

s имеет значение null.

FormatException

s не является допустимой конечной точкой IP.

Parse(String)

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

IPEndPoint.cs

Преобразует конечную точку IP-сети (адрес и порт), представленную в виде строки, в экземпляр IPEndPoint.

public:
 static System::Net::IPEndPoint ^ Parse(System::String ^ s);

public static System.Net.IPEndPoint Parse (string s);

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

Public Shared Function Parse (s As String) As IPEndPoint

Параметры

s

String

Строка, содержащая конечную точку IP, выраженную в виде четырех чисел, разделенных точками, или в сетевом байтовом формате в случае протокола IPv4 и в системе записи "двоеточие-шестнадцатиричное число" в случае протокола IPv6.

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

IPEndPoint

Объектное представление конечной точки IP-сети.

Исключения

ArgumentNullException

s имеет значение null.

FormatException

s не является допустимой конечной точкой IP.