IPEndPoint.TryParse Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| TryParse(ReadOnlySpan<Byte>, IPEndPoint) | |
| TryParse(String, IPEndPoint) |
Пытается преобразовать конечную точку IP-сети (адрес и порт), представленную как строку в эквивалент IPEndPoint , и возвращает значение, указывающее, успешно ли выполнено преобразование. |
| TryParse(ReadOnlySpan<Char>, IPEndPoint) |
Пытается преобразовать конечную точку IP-сети (адрес и порт), представленную как диапазон только для чтения, в эквивалентную IPEndPoint и возвращает значение, указывающее, выполнено ли преобразование успешно. |
Комментарии
Количество частей (каждая часть разделена точкой) определяет s , как создается IP-адрес конечной точки. Адрес одной части хранится непосредственно в сетевом адресе. Двухкомпонентный адрес, удобный для указания адреса класса A, помещает в первую байтовую часть и конечную часть в правой части сетевого адреса. Трехкомпонентный адрес, удобный для указания адреса класса B, помещает первую часть в первый байт, вторую часть во второй байт и последнюю часть в правой части сетевого адреса. Рассмотрим пример.
Количество частей и примеров s |
IPv4-адрес для IPEndPoint.Address | Порт |
|---|---|---|
| 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<Byte>, IPEndPoint)
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);
public static bool TryParse(ReadOnlySpan<byte> utf8Text, out System.Net.IPEndPoint? result);
static member TryParse : ReadOnlySpan<byte> * IPEndPoint -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As IPEndPoint) As Boolean
Параметры
- utf8Text
- ReadOnlySpan<Byte>
- result
- IPEndPoint
Возвращаемое значение
Применяется к
TryParse(String, IPEndPoint)
- Исходный код:
- IPEndPoint.cs
- Исходный код:
- IPEndPoint.cs
- Исходный код:
- IPEndPoint.cs
- Исходный код:
- 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);
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.
Возвращаемое значение
true Значение , если s можно проанализировать как конечную точку IP; в противном случае false.
Применяется к
TryParse(ReadOnlySpan<Char>, IPEndPoint)
- Исходный код:
- IPEndPoint.cs
- Исходный код:
- IPEndPoint.cs
- Исходный код:
- IPEndPoint.cs
- Исходный код:
- 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);
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.
Возвращаемое значение
true Значение , если s можно проанализировать как конечную точку IP; в противном случае false.