Expand Minimize

UriIdnScope Enumeration

Provides the possible values for the configuration setting of the System.Configuration.IdnElement in the System.Configuration namespace.

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

public enum UriIdnScope

Member nameDescription
NoneThis value will not convert any Unicode domain names to use Punycode. This is the default value which is consistent with the .NET Framework 2.0 behavior.
AllExceptIntranetThis value will convert all external Unicode domain names to use the Punycode equivalents (IDN names). In this case to handle international names on the local Intranet, the DNS servers that are used for the Intranet should support Unicode names.
AllThis value will convert any Unicode domain names to their Punycode equivalents (IDN names).

The existing Uri class has been extended to provide support for International Resource Identifiers (IR) based on RFC 3987. Current users will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. This ensures application compatibility with prior versions of the .NET Framework.

The Internationalized Domain Name (IDN) attribute only controls IDN processing. All other IRI processing (character normalization, for example) is always performed by default.

The configuration setting for the System.Configuration.IdnElement will be read once when the first Uri class is constructed. Changes to configuration settings after that time are ignored.

For more information on IRI support, see the Remarks section for the Uri class.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

ADD
Show:
© 2014 Microsoft