IdnMapping.AllowUnassigned Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that indicates whether unassigned Unicode code points are used in operations performed by members of the current IdnMapping object.
public:
property bool AllowUnassigned { bool get(); void set(bool value); };
public bool AllowUnassigned { get; set; }
member this.AllowUnassigned : bool with get, set
Public Property AllowUnassigned As Boolean
Property Value
true
if unassigned code points are used in operations; otherwise, false
.
Remarks
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
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.