GenericUriParserOptions Enumeration (System)

GenericUriParserOptions Enumeration

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

GenericUriParserOptions Enumeration

Specifies options for a UriParser.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

Visual Basic (Declaration)

<FlagsAttribute> _
Public Enumeration GenericUriParserOptions

Visual Basic (Usage)

Dim instance As GenericUriParserOptions

[FlagsAttribute]
public enum GenericUriParserOptions

Visual C++

[FlagsAttribute]
public enum class GenericUriParserOptions

JScript

public enum GenericUriParserOptions

Members

	Member name	Description
	Default	The parser: requires an authority converts back slashes into forward slashes unescapes path dots, forward slashes, and back slashes
	GenericAuthority	The parser allows a registry-based authority.
	AllowEmptyAuthority	The parser allows a URI with no authority.
	NoUserInfo	The scheme does not define a user information part.
	NoPort	The scheme does not define a port.
	NoQuery	The scheme does not define a query part.
	NoFragment	The scheme does not define a fragment part.
	DontConvertPathBackslashes	The parser does not convert back slashes into forward slashes.
	DontCompressPath	The parser does not canonicalize the URI.
	DontUnescapePathDotsAndSlashes	The parser does not unescape path dots, forward slashes, or back slashes.
	Idn	The parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Whether IDN is used is dictated by configuration values. See the Remarks for more information.
	IriParsing	The parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). Whether IRI is used is dictated by configuration values. See the Remarks for more information.

Remarks

You can combine any of these options to configure a generic URI parser by passing the options as a parameter to the GenericUriParser..::.GenericUriParser(GenericUriParserOptions) 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.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

System Namespace

System.Configuration..::.IdnElement

System.Configuration..::.IriParsingElement

System..::.Uri