IPEndPoint.Parse 方法

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

重载

Parse(ReadOnlySpan<Char>)	将表示为只读范围的 IP 网络终结点（地址和端口）转换为 IPEndPoint 实例。
Parse(String)	将表示为字符串的 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 地址需要括在方括号 [] 中;否则，不强制使用方括号。

Parse(ReadOnlySpan<Char>)

Source:

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)

Source:

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 终结点。