IdnMapping.GetUnicode Method (String, Int32, Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Decodes a substring of a specified length that contains one or more domain name labels, encoded according to the IDNA standard, to a string of Unicode characters.

Namespace:   System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

public string GetUnicode(
	string ascii,
	int index,
	int count


Type: System.String

The string to decode, which consists of one or more labels in the US-ASCII character range (U+0020 to U+007E) encoded according to the IDNA standard.

Type: System.Int32

A zero-based offset into ascii that specifies the start of the substring.

Type: System.Int32

The number of characters to convert in the substring that starts at the position specified by index in the ascii string.

Return Value

Type: System.String

The Unicode equivalent of the IDNA substring specified by the ascii, index, and count parameters.

Exception Condition

ascii is null.


index or count is less than zero.


index is greater than the length of ascii.


index is greater than the length of ascii minus count.


ascii is invalid based on the AllowUnassigned and UseStd3AsciiRules properties, and the IDNA standard.

For more information about domain names, labels, and label separators, see the remarks for the IdnMapping.GetAscii(String, Int32, Int32) method.

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0
Return to top