IPEndPoint.TryParse 方法

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

重载

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 地址也是如此。 例如，如果 为“1”，则此方法返回 true，即使“1” (或 0.0.0.1) 不是有效的 IP 地址，并且您可能希望此方法返回 false。 修复此 bug 会中断现有应用，因此不会更改当前行为。 代码可以通过确保仅使用此方法以点十进制格式分析 IP 地址来避免此行为。

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

TryParse(ReadOnlySpan<Char>, IPEndPoint)

Source:

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

此方法返回时，为 s 的 IPEndPoint 版本。

返回

Boolean

如果 s 可分析为 IP 终结点，则为 true；否则为 false。

TryParse(String, IPEndPoint)

Source:

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

此方法返回时，为 s 的 IPEndPoint 版本。

返回

Boolean

如果 s 可分析为 IP 终结点，则为 true；否则为 false。