GenericUriParser Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

A customizable parser for a hierarchical URI.

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


public class GenericUriParser : UriParser


Create a customizable parser for a hierarchical URI.


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_protmethodGetComponents(Uri, UriComponents, UriFormat)

Gets the components from a URI.(Inherited from UriParser.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodInitializeAndValidate(Uri, UriFormatException)

Initialize the state of the parser and validate the URI.(Inherited from UriParser.)

System_CAPS_protmethodIsBaseOf(Uri, Uri)

Determines whether baseUri is a base URI for relativeUri.(Inherited from UriParser.)


Indicates whether a URI is well-formed.(Inherited from UriParser.)


Creates a shallow copy of the current Object.(Inherited from Object.)


Invoked by a Uri constructor to get a UriParser instance(Inherited from UriParser.)

System_CAPS_protmethodOnRegister(String, Int32)

Invoked by the Framework when a UriParser method is registered.(Inherited from UriParser.)

System_CAPS_protmethodResolve(Uri, Uri, UriFormatException)

Called by Uri constructors and Uri.TryCreate to resolve a relative URI.(Inherited from UriParser.)


Returns a string that represents the current object.(Inherited from Object.)

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

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.

.NET Framework
Available since 2.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0

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

Return to top