System.Configuration.IdnElement Class

Provides the configuration setting for International Domain Name (IDN) processing in the Uri class.

See Also: IdnElement Members


public sealed class IdnElement : ConfigurationElement


The existing Uri class has been extended to provide support for International Resource Identifiers (IRI) 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 configuration setting for the System.Configuration.IdnElement is indirectly controlled by the System.Configuration.IriParsingElement configuration setting that controls IRI processing in the Uri class. IRI processing must be enabled for IDN processing to be possible. If IRI processing is disabled, then IDN processing will be set to the default setting where the .NET Framework 2.0 behavior is used for compatibility and IDN names are not used.

The Internationalized Domain Name (IDN) attribute only controls IDN processing. All other IRI processing (character normalization, for example) is 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.


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