UriSection.IriParsing Property

Definition

Gets an IriParsingElement object that contains the configuration setting for International Resource Identifiers (IRI) parsing in the Uri class.

[System.Configuration.ConfigurationProperty("iriParsing")]
public System.Configuration.IriParsingElement IriParsing { get; }
public System.Configuration.IriParsingElement IriParsing { get; }

Property Value

The configuration setting for International Resource Identifiers (IRI) parsing in the Uri class.

Attributes

Remarks

The existing System.Uri class has been extended to provide support for International Resource Identifiers (IRI) and Internationalized Domain Names. Current users will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI and IDN. This ensures application compatibility with prior versions of the .NET Framework.

The configuration settings for IRI and IDN can be retrieved using the UriSection class. The IriParsing property returns the configuration setting for IRI parsing in the System.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 IriParsingElement will be read once when the first System.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 System.Uri class.

Applies to

Product Versions
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also