Parse Method
Collapse the table of content
Expand the table of content

IPAddress.Parse Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Converts an IP address string to an IPAddress instance.

Namespace:  System.Net
Assembly:  System.Net (in System.Net.dll)

public static IPAddress Parse(
	string ipString
)

Parameters

ipString
Type: System.String
A string that contains an IP address in dotted-quad notation for IPv4 or an IP address in colon-hexadecimal notation for IPv6.

Return Value

Type: System.Net.IPAddress
An IPAddress instance.

ExceptionCondition
ArgumentNullException

The ipString parameter is null.

FormatException

The ipString parameter is not a valid IP address.

The static Parse method creates an IPAddress instance from an IP address expressed in dotted-quad notation for IPv4 or an IP address expressed in colon-hexadecimal notation for IPv6.

For IPv4, the number of parts (each part is separated by a period) in ipString determines how the IP address is constructed. A one part address is stored directly in the network address. A two part address, convenient for specifying a class A address, puts the leading part in the first byte and the trailing part in the right-most three bytes of the network address. A three part address, convenient for specifying a class B address, puts the first part in the first byte, the second part in the second byte, and the final part in the right-most two bytes of the network address. For example:

Number of parts and example ipString

IPv4 address for IPAddress

1 -- "65536"

0.0.255.255

2 -- "20.2"

20.0.0.2

2 -- "20.65535"

20.0.255.255

3 -- "128.1.2"

128.1.0.2

For IPv6, the Scope Id is also parsed if this present in the ipString parameter.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Windows Phone

Show:
© 2017 Microsoft