Click here to Skip to main content
15,867,308 members
Articles / Web Development / ASP.NET

A Small Class for Simplifying the Work with URL Parameters

Rate me:
Please Sign up or sign in to vote.
4.77/5 (42 votes)
4 Apr 2010CPOL3 min read 166.6K   873   105   43
An article describing a simple class that makes working with URL parameters a little bit easier
An URL inside the Microsoft Internet Explorer Address bar

Introduction

(For the latest changes, please see the History section below.)

If you are working with URLs from within ASP.NET, you probably often need to read different URL parameters. E.g., you could read the value of the "name1" parameter out of the QueryString collection of your Page class (or, to be more precise, from the Request property of your Page class):

C#
private void Page_Load(
    object sender, 
    System.EventArgs e )
{
    string value1 = Request.QueryString["name1"];
 
    // ... Further processing of the value1 variable ... 
}

In my projects, I often need the ability to write URL parameters, e.g., for outputting a URL on a page or for redirecting to another page with the appropriate parameters. This article introduces a class QueryString which I wrote in order to simplify my life a little bit.

Some Examples

Before examining the QueryString class in more detail, first some examples of how to use it are shown.

Example 1 - Manipulate an attribute value

Create a QueryString and simply let itself fill with the parameters of the current page:

C#
private void Page_Load(
    object sender, 
    System.EventArgs e )
{
    // Let the object fill itself 
    // with the parameters of the current page.
    QueryString qs = new QueryString();
 
    // Read a parameter from the QueryString object.
    string value1 = qs["name1"];
  
    // Write a value into the QueryString object.
    qs["name1"] = "This is a value";
  
    // Redirect with the current content of the QueryString object.
    // In this example, since the BeforeUrl property is not modified,
    // it will redirect to the current page itself, but with the
    // "name1" parameter set to the new value.
    Response.Redirect( qs.All, true );
}

As you can see, you can simply modify a parameter's value by assigning it to the appropriate parameter name by using the [] operator. The All property returns the complete URL that is stored inside the QueryString object including the latest (possibly modified) parameters.

Example 2 - Removing parameters

To remove a certain parameter from the QueryString object, call the RemoveParameter method, specifying the name of the parameter to remove:

C#
private void Page_Load(
    object sender, 
    System.EventArgs e )
{
    // Let the object fill itself 
    // with the parameters of the current page.
    QueryString qs = new QueryString();
 
    // Read a parameter from the QueryString object.
    string value1 = qs["name1"];
  
    // Now remove the parameter.
    qs.RemoveParameter( "name1" );
   
    // This has the same effect as RemoveParameter() method:
    qs["name1"] = null;
  
    // ... Further processing of the value1 variable ... 
}

The Class in Brief

The most common use of the class was already described in the previous section. It should be simple to use, n'est pas? Nevertheless, here is an (incomplete) overview of the most usable members:

Constructors

The following constructors exists.

  • public QueryString() - Empty constructor, fills itself with the parameters of the current page (if any)
  • public QueryString( System.Web.UI.Page currentPage ) - Constructs with the parameters of the given page
  • public QueryString( string url ) - Constructs with the parameters from the given URL
  • public QueryString( Uri uri ) - Constructs with the parameters from the given URI

Methods for reading from a given URL

By using the following methods, you can achieve similar results as with the constructors, but after the object is already constructed.

  • public void FromUrl( System.Web.UI.Page currentPage ) - Fills with the parameters of the given page
  • public void FromUrl( string url ) - Fills with the parameters from the given URL
  • public void FromUrl( Uri uri ) - Fills with the parameters from the given URI

Miscellaneous operations

Use the following methods for further operations.

  • public bool HasParameter( string parameterName ) - Check whether a given parameter is present (i.e. is non-null and non-empty-string)
  • public void RemoveParameter( string name ) - Removes a parameter from the current parameter collection. Does nothing if the parameter is not present
  • public void RemoveAllParameters() - Removes all parameters from the current parameter collection

Miscellaneous properties

Use the following properties for accessing various values.

  • public string this [string index] - Gets or sets a parameter value by the given parameter name. If the parameter does not exists, get returns string.Empty (i.e. not null).
  • public string BeforeUrl - Gets or sets the the "base" part of the URL returned by the All property. E.g. set this to "http://www.myserver.com/mypage.aspx"
  • public string All - Gets the complete URL that is currently stored inside the object. This is the value of the All property plus the current parameters. E.g. returns "http://www.myserver.com/mypage.aspx?name1=value1&name2=someOtherValue".

Conclusion

In this small article, I've shown you a class that simplifies the reading and writing of URL parameter values. For me, this class is around about approximately two years and helped me save a lot of coding time (well, at least a bit...). Hopefully it is useful for you, too.

For questions, comments and remarks, please use the commenting section at the bottom of this article.

History

  • 2010-04-05: Added new version that adds several new methods (like a HTTP 301 redirect, which is good for SEO) and makes use of the concept of a Fluent interface
  • 2005-01-06: Corrected some very small spelling errors
  • 2004-12-30: Added fix and suggestion from Chris Maunder
  • 2004-12-14: Created first version of article

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Chief Technology Officer Zeta Software GmbH
Germany Germany
Uwe does programming since 1989 with experiences in Assembler, C++, MFC and lots of web- and database stuff and now uses ASP.NET and C# extensively, too. He has also teached programming to students at the local university.

➡️ Give me a tip 🙂

In his free time, he does climbing, running and mountain biking. In 2012 he became a father of a cute boy and in 2014 of an awesome girl.

Some cool, free software from us:

Windows 10 Ereignisanzeige  
German Developer Community  
Free Test Management Software - Intuitive, competitive, Test Plans.  
Homepage erstellen - Intuitive, very easy to use.  
Offline-Homepage-Baukasten

Comments and Discussions

 
GeneralValidation Pin
Alkha18-Jan-05 3:50
Alkha18-Jan-05 3:50 
GeneralRe: Validation Pin
Uwe Keim18-Jan-05 17:25
sitebuilderUwe Keim18-Jan-05 17:25 
Generalretrieving passed param values from redirected page Pin
misha20006-Jan-05 3:40
misha20006-Jan-05 3:40 
GeneralRe: retrieving passed param values from redirected page Pin
Uwe Keim6-Jan-05 3:51
sitebuilderUwe Keim6-Jan-05 3:51 
GeneralRe: retrieving passed param values from redirected page Pin
misha20006-Jan-05 22:34
misha20006-Jan-05 22:34 
GeneralRe: retrieving passed param values from redirected page Pin
Uwe Keim7-Jan-05 7:26
sitebuilderUwe Keim7-Jan-05 7:26 
GeneralMinor bug fix Pin
Chris Maunder29-Dec-04 16:28
cofounderChris Maunder29-Dec-04 16:28 
GeneralRe: Minor bug fix Pin
Uwe Keim29-Dec-04 16:55
sitebuilderUwe Keim29-Dec-04 16:55 
GeneralRe: Minor bug fix Pin
Uwe Keim29-Dec-04 23:56
sitebuilderUwe Keim29-Dec-04 23:56 
GeneralGood timing! Pin
Chris Maunder25-Dec-04 23:32
cofounderChris Maunder25-Dec-04 23:32 
GeneralRe: Good timing! Pin
Uwe Keim26-Dec-04 18:05
sitebuilderUwe Keim26-Dec-04 18:05 
GeneralGood Idea! Pin
Webdiyer14-Dec-04 14:04
Webdiyer14-Dec-04 14:04 
GeneralRe: Good Idea! Pin
Uwe Keim14-Dec-04 17:27
sitebuilderUwe Keim14-Dec-04 17:27 

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

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