IPEndPoint.TryParse Метод

Определение

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

System.Net

Сборка:

System.Net.Primitives.dll

Перегрузки

TryParse(ReadOnlySpan<Char>, IPEndPoint)	Пытается преобразовать конечную точку IP-сети (адрес и порт), представленную в виде диапазона, доступного только для чтения, в его эквивалент IPEndPoint и возвращает значение, указывающее, было ли выполнено преобразование.
TryParse(String, IPEndPoint)	Пытается преобразовать конечную точку 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-адреса должны быть заключены в квадратные скобки [] при передаче конечной точки, указывающей номер порта; В противном случае квадратные скобки не являются обязательными.

TryParse(ReadOnlySpan<Char>, IPEndPoint)

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

IPEndPoint.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);

public static bool TryParse (ReadOnlySpan<char> s, out System.Net.IPEndPoint? result);

static member TryParse : ReadOnlySpan<char> * IPEndPoint -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As IPEndPoint) As Boolean

Параметры

s

ReadOnlySpan<Char>

Проверяемая конечная точка IP.

result

IPEndPoint

При возврате этот метод содержит версию IPEndPoint для s.

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

Boolean

Значение true, если s можно проанализировать как конечную точку IP. В противном случае — значение false.

TryParse(String, IPEndPoint)

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

IPEndPoint.cs

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

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);

public static bool TryParse (string s, out System.Net.IPEndPoint? result);

static member TryParse : string * IPEndPoint -> bool

Public Shared Function TryParse (s As String, ByRef result As IPEndPoint) As Boolean

Параметры

s

String

Проверяемая конечная точка IP.

result

IPEndPoint

При возврате этот метод содержит версию IPEndPoint для s.

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

Boolean

Значение true, если s можно проанализировать как конечную точку IP. В противном случае — значение false.