Partager via

  • Article

IPAddress.TryParse Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Determines whether a string is a valid IP address.

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

Syntax

'Declaration
Public Shared Function TryParse ( _
    ipString As String, _
    <OutAttribute> ByRef address As IPAddress _
) As Boolean

public static bool TryParse(
    string ipString,
    out IPAddress address
)

Parameters

Return Value

Type: System.Boolean
true if ipString is a valid IP address; otherwise, false.

Exceptions

Exception Condition
ArgumentException

ipString could not be parsed as an IP address.
ArgumentNullException

ipString is nulla null reference (Nothing in Visual Basic).
FormatException

ipString is not a valid IP address.

Remarks

This method tries to parse 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 and validated if this present in the ipString parameter.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.