System.NotSupportedException can result

[amp64]

I am passing an IPv6 IPAddress and I get a System.NotSupportedException. The message is "This protocol version is not supported". Although I cannot suggest a solution (yet), this should be added as a possible result to the docs.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: b46fa10a-00fe-9a1e-38f4-8ace5ba3d6e0
• Version Independent ID: b88a04ff-ecb2-eb57-97fe-021928c22cfa
• Content: TcpClient.ConnectAsync Method (System.Net.Sockets)
• Content Source: xml/System.Net.Sockets/TcpClient.xml
• Product: .net
• GitHub Login: @dotnet-bot
• Microsoft Alias: dotnetcontent

[amp64]

NotSupportedException happens when you use an IPv6 address with a default TcpClient instance. You have to use an IPv6 instance of TcpClient for this to work. Not at all obvious, to me anyway.

[mairaw]

@davidsh @karelz can you look at this feedback and see if there are any improvements we can make?

[karelz]

TcpClient constructor already mentions that it works only with IPv4.
It might make sense to add remark "If you receive NotSupportedException with message "This protocol version is not supported" while using IPv6 address, then make sure you enabled IPv6 in constructor TcpClient(AddressFamily.InterNetworkV6)"

We would need the remark on all Connect, ConnectAsync and BeginConnect methods which take IPAddress or IPEndPoint as args.