Article
11/18/2011

GenericUriParser Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

A customizable parser for a hierarchical URI.

Inheritance Hierarchy

System.Object
System.UriParser
System.GenericUriParser

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

Syntax

'Declaration
Public Class GenericUriParser _
    Inherits UriParser

public class GenericUriParser : UriParser

The GenericUriParser type exposes the following members.

Constructors

	Name	Description
	GenericUriParser	Create a customizable parser for a hierarchical URI.

Top

Methods

	Name	Description
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GetComponents	Gets the components from a URI. (Inherited from UriParser.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeAndValidate	Initialize the state of the parser and validate the URI. (Inherited from UriParser.)
	IsBaseOf	Determines whether baseUri is a base URI for relativeUri. (Inherited from UriParser.)
	IsWellFormedOriginalString	Indicates whether a URI is well-formed. (Inherited from UriParser.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnNewUri	Invoked by a Uri constructor to get a UriParser instance (Inherited from UriParser.)
	OnRegister	Invoked by the Framework when a UriParser method is registered. (Inherited from UriParser.)
	Resolve	Called by Uri constructors and Uri.TryCreate() to resolve a relative URI. (Inherited from UriParser.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

If you want to create a parser based on a well-known scheme, use HttpStyleUriParser or FtpStyleUriParser.

When creating a customizable parser, the behavior of the parser is specified by passing a bitwise combination of the values available in the System.GenericUriParserOptions enumeration to the GenericUriParser constructor.

The existing System.Uri class has been extended to provide support for International Resource Identifiers (IRI) and Internationalized Domain Names (IDN). 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.

All parsers derived from GenericUriParser will not gain IRI and IDN support by default. The Default option does not include IRI and IDN support. Two new values are added to the System.GenericUriParserOptions enumeration to indicate if a custom parser supports IRI and IDN.

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Share via