IPEndPoint.TryParse 方法

定义

重载

TryParse(ReadOnlySpan<Char>, IPEndPoint)

尝试将表示为只读范围的 IP 网络终结点(地址和端口)转换为其 IPEndPoint 等效项,返回指示转换是否成功的值。

TryParse(String, IPEndPoint)

尝试将表示为字符串的 IP 网络终结点(地址和端口)转换为其 IPEndPoint 等效项,返回指示转换是否成功的值。

注解

每个部分 (部分的数目由句点分隔,) s 确定终结点的 IP 地址的构造方式。 一部分地址直接存储在网络地址中。 一个两部分地址,方便指定类 A 地址,将前导部分置于第一个字节中,尾随部分放在网络地址最右侧的三个字节中。 一个三部分地址,方便指定类 B 地址,将第一部分放在第一个字节中,第二个字节放在第二个字节中,最后一部分放在网络地址最右侧的两个字节中。 例如:

部件数和示例 s IPEndPoint.Address 的 IPv4 地址 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 构造函数的长度值。 这意味着,如果成功分析 Int64,则此方法返回 true,即使它表示不是有效 IP 地址的地址也是如此。 例如,如果 s 为“1”,则此方法返回 true,即使“1” (或 0.0.0.1) 不是有效的 IP 地址,你可能希望此方法返回 false。 修复此 bug 会中断现有应用,因此不会更改当前行为。 代码可以避免此行为,方法是确保它仅使用此方法以 dotted-decimal 格式分析 IP 地址。

传递指定端口号的终结点时,文本 IPv6 地址需要括在方括号 [] 中;否则,不强制使用方括号。

TryParse(ReadOnlySpan<Char>, IPEndPoint)

尝试将表示为只读范围的 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

此方法返回时,为 sIPEndPoint 版本。

返回

Boolean

如果 s 可分析为 IP 终结点,则为 true;否则为 false

适用于

TryParse(String, IPEndPoint)

尝试将表示为字符串的 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

此方法返回时,为 sIPEndPoint 版本。

返回

Boolean

如果 s 可分析为 IP 终结点,则为 true;否则为 false

适用于