IdnMapping.AllowUnassigned Property

Gets or sets a value that indicates whether unassigned Unicode code points are used in operations performed by members of the current IdnMapping object.

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

member AllowUnassigned : bool with get, set

Property Value

Type: System.Boolean
true if unassigned code points are used in operations; otherwise, false.

A registered domain name cannot contain unassigned code points. Consequently, the default value of the AllowUnassigned property is false. The IDNA specification permits unassigned code points only in queries for matching strings (that is, in domain name lookup). For more information about the use of unassigned code points in domain names, see RFC 3454, "Preparation of Internationalized Strings (stringprep)" and RFC 5891, "Internationalized Domain Names in Applications (IDNA): Protocol".

Important noteImportant

If the AllowUnassigned property is false, the behavior associated with the property depends on the underlying operating system. On Windows 8, the IdnMapping class conforms to IDNA 2008, which is based on the Unicode 6.0 standard. On previous versions of Windows, the IdnMapping class is based on IDNA 2003, which is based on Unicode 3.x. Some code points that were unassigned in IDNA 2003 have been assigned characters and are supported in IDNA 2008. For example, U+0221 was introduced in Unicode 4.0. On Windows 8, it is encoded as "xn—6la". On previous versions of Windows, it throws an ArgumentException exception.

.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.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft