IPAddress.MapToIPv4 Method ()

.NET Framework (current version)
 

Maps the IPAddress object to an IPv4 address.

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

Public Function MapToIPv4 As IPAddress

Return Value

Type: System.Net.IPAddress

Returns IPAddress.

An IPv4 address.

Dual-stack sockets always require IPv6 addresses. The ability to interact with an IPv4 address requires the use of the IPv4-mapped IPv6 address format. Any IPv4 addresses must be represented in the IPv4-mapped IPv6 address format which enables an IPv6 only application to communicate with an IPv4 node. The IPv4-mapped IPv6 address format allows the IPv4 address of an IPv4 node to be represented as an IPv6 address. The IPv4 address is encoded into the low-order 32 bits of the IPv6 address, and the high-order 96 bits hold the fixed prefix 0:0:0:0:0:FFFF. The IPv4-mapped IPv6 address format is specified in RFC 4291. For more information, see www.ietf.org/rfc/rfc4291.txt.

If you want to use MapToIPv4 to convert an IPv4 address from IPv6 format to IPv4 format, you must first ensure that you've got an IPv4 address. Call IsIPv4MappedToIPv6, which will return true if the IP address is originally IPv4 written as IPv6, or false otherwise. If IsIPv4MappedToIPv6 returns true, use MapToIPv4 to make the conversion.

Universal Windows Platform
Available since 10
.NET Framework
Available since 4.5
Return to top
Show: