Export (0) Print
Expand All

IdnMapping::GetUnicode Method (String, Int32, Int32)

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)

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.


ascii is nullptr.


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.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft