Click here to Skip to main content
Click here to Skip to main content
Go to top

A useful UrlBuilder class

, 18 Aug 2005
Rate this:
Please Sign up or sign in to vote.
A simple way to generate and manipulate URLs.

Introduction

Building URLs is something one does all the time as an ASP.NET developer. The .NET Framework has generously provided many classes to help us simplify the problem, but after all my searching, the one thing I found missing from the framework was a way to easily work with QueryString parameters. I did a little looking around and found a few solutions to the problem written by various people but none of them built on anything already in the framework. The framework provides the very useful System.UriBuilder class but it has no in-built way to deal with QueryString parameters apart from being able to get back a string containing the Query portion of the URI. While this is not all that useful in itself, it does help us create a derived class which extends the functionality in UriBuilder. Enter UrlBuilder. While UriBuilder is a more accurate name given modern naming conventions, UrlBuilder is semantically equivalent and more importantly, not a duplicate name of anything already in the framework.

If the reader wishes to get elbow deep in the code to discover its inner workings, it is provided in the download for your perusal and should be immediately obvious how it all hangs together. All I shall attempt to do here is give a brief explanation of how to use the UrlBuilder class by means of some sample code which will hopefully outline and highlight the salient features of this class. So then, without further delay, let's delve in.

The UrlBuilder class can be instantiated in several ways, but for simplicity, let's assume the user wishes to use a string as the initialiser of this UrlBuilder instance.

UrlBuilder builder = new 
    UrlBuilder(“http://www.codeproject.com/index.asp?cat=4”);

The rest of the constructor overloads provided in the class are exactly the same as those of the base UriBuilder class with the exception of one additional which takes a System.Web.UI.Page object. This is useful when one wishes to merely redirect to the same page with different QueryString parameters. The object can also be initialised using a System.Uri object. Once instantiated, we can manipulate any part of the URI (see the System.Uri documentation).

builder.Host = “www.gibbons.co.za”;
builder.Path = “archive/2005”;

It is interesting to note that a forward slash “/” is optional at the start of the Path string. Either way, the UriBuilder class will return a correctly formed URI. The UriBuilder class provides no way to set only the page name portion of the URI, so I added a new property called PageName which allows you to set only the name of the required page.

builder.PageName = “06.aspx”;

So far, apart from the PageName property, this is nothing new; all this can already be done with the UriBuilder class. The real usefulness of the UrlBuilder class becomes apparent when we try to manipulate the QueryString parameters, as follows:

builder.QueryString[“cat”] = 12345;
builder.QueryString[“a”] = “A”;
builder.QueryString[“b”] = “B”; 

If the QueryString already contains a parameter contained in the URI passed to the constructor (in this case “cat”), the value of the parameter will be overwritten with the new value. If the parameter doesn’t already exist, it is appended to the QueryString generated. In addition, all the properties and methods of the internal StringDictionary object used to store the QueryString pairs are made available to the user. You could, for example, remove one of the parameters:

builder.QueryString.Remove(“cat”); 

Or check if the collection contains a given key or value:

builder.QueryString.ContainsKey(“cat”);
builder.QueryString.ContainsValue(“12345”);

Lastly, there are two ways in which the URI may be consumed. Firstly, by calling:

string uri = builder.ToString(); 

Or simply by calling:

builder.Navigate(); 

which will perform a redirect to the URI currently contained in the object.

Happy coding.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

lotuspro
Web Developer
United Kingdom United Kingdom
No Biography provided

Comments and Discussions

 
GeneralMy vote of 3 PinmemberQwertie28-Feb-14 8:49 
SuggestionPlease add to NuGet PinmemberShimmy Weitzhandler1-Nov-12 10:54 
GeneralRe: Please add to NuGet PinmemberShimmy Weitzhandler1-Nov-12 11:59 
Generallicence info PinmemberShameet Doshi21-Jul-10 3:09 
GeneralRe: licence info Pinmemberlotuspro21-Jul-10 3:29 
GeneralNull Exception Issue Pinmemberj105 Rob19-Dec-06 12:49 
GeneralYou're great! Thanks for your sharing! Pinmemberzhang.hong8-Dec-06 20:47 
GeneralAmazing helper! PinmemberRaven#37710-Aug-06 11:40 
AnswerRe: Amazing helper! Pinmemberlotuspro11-Aug-06 0:32 
GeneralMinor problem PinmemberOskar Austegard18-Aug-05 8:13 
GeneralRe: Minor problem Pinmemberlotuspro18-Aug-05 9:49 
GeneralSimilar to my article :-) PinsitebuilderUwe Keim20-Jul-05 10:24 
GeneralRe: Similar to my article :-) PinmemberOskar Austegard18-Aug-05 7:34 
GeneralRe: Similar to my article :-) PinsitebuilderUwe Keim18-Aug-05 7:57 
GeneralRe: Similar to my article :-) PinmemberOskar Austegard18-Aug-05 8:23 
GeneralRe: Similar to my article :-) Pinmemberlotuspro18-Aug-05 9:57 
GeneralRe: Similar to my article :-) PinmemberOskar Austegard18-Aug-05 10:14 
GeneralRe: Similar to my article :-) Pinmemberlotuspro18-Aug-05 11:10 
GeneralNice KISS job... one minor change. PinmemberMarc Brooks20-Jul-05 8:34 
GeneralRe: Nice KISS job... one minor change. Pinmemberlotuspro20-Jul-05 9:02 
GeneralRe: Nice KISS job... one minor change. PinmemberThomas Freudenberg25-Jul-05 21:08 
GeneralRe: Nice KISS job... one minor change. Pinmemberlotuspro25-Jul-05 22:44 
GeneralNice and clean PinmemberAshaman20-Jul-05 7:22 
GeneralNOTE From Author - Broken download link Pinmemberlotuspro20-Jul-05 4:46 
GeneralUrlBuilder_src.zip doesn't exist PinmemberDeKale20-Jul-05 3:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140916.1 | Last Updated 19 Aug 2005
Article Copyright 2005 by lotuspro
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid