GenericUriParserOptions Enumeration

Specifies options for a UriParser.

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

public enum GenericUriParserOptions
/** @attribute FlagsAttribute() */ 
public enum GenericUriParserOptions
public enum GenericUriParserOptions

 Member nameDescription
AllowEmptyAuthorityThe parser allows a URI with no authority. 
DefaultThe parser: 
  • requires an authority

  • converts back slashes into forward slashes

  • unescapes path dots, forward slashes, and back slashes

DontCompressPathThe parser does not canonicalize the URI. 
DontConvertPathBackslashesThe parser does not convert back slashes into forward slashes. 
DontUnescapePathDotsAndSlashesThe parser does not unescape path dots, forward slashes, or back slashes. 
GenericAuthorityThe parser allows a registry-based authority. 
NoFragmentThe scheme does not define a fragment part. 
NoPortThe scheme does not define a port. 
NoQueryThe scheme does not define a query part. 
NoUserInfoThe scheme does not define a user information part. 

You can combine any of these options to configure a generic URI parser by passing the options as a parameter to the System.GenericUriParser constructor.

The existing System.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 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.

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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions