Passing Parameters from One Page to AnotherBy John Tabernik and Scott Mitchell
Passing parameters from one page to another is a very common task in Web development. Granted, its importance and frequency has faded a bit with ASP.NET's inherent preference for postback forms, but regardless, there are still many situations in which you need to pass data from one Web page to another. One of the simplest and most efficient ways of passing parameters among pages is to use the querystring. Unfortunately, packing data into the querystring via string manipulations can quickly lead to cumbersome and often difficult to maintain code, especially as the parameter list grows. Consider the following C# code to pass a number of parameters from on the querystring:
This code is somewhat unclear, making it hard to see at a glance what the variable names on the querystring are, and what values are being passed for each variable. Further, changes to variables that are passed are more cumbersome and prone to error than they need to be.
Using the example set by .NET's
I built a simple class that provides clean, straightforward access to the URL and parameter set, making code easier to read
and maintain, no matter how many parameters you need to pass. Later I augmented this class to also allow passing of parameters
from one page to another through Session variables.
In this article we will examine the source code for the augmented class and look at an example of using this functionality in an ASP.NET application.
Starting from the Base...
Initially I created just a simple class for passing parameters through the querystring, which met my needs at the time. But thinking more about my class, I realized that the high-level aim was to pass data from one page to another - why should I limit it to using the querystring? I decided to take a step back and define the functionality needed for passing data from one page to another, ignoring the actual implementation details.
In order to pass data from one page to another I reasoned that the following would be needed:
- The URL of the page that is to receive the data
- The name/value pairs of the data to pass
- A method that, when called, will pass the supplied data to the specified page
- Extract the value for a name/value pair
- Enumerate all values in the parameter collection
ParameterPasserTesterand made it
abstract, meaning that it had to be extended. My aim for providing a concrete implementation - using the querystring or Session variables - was to create classes that were derived from
ParameterPasserTesterand included the code to work with the particular, concrete technique.
The following is the complete code for the
ParameterPasserTester base class. (The complete working code and
a sample are available at the end of this article.)
As the code shows, this base class has a
Url property that indicates the page the data should be passed to.
It also has two
Keys, which returns a collection of the parameter keys, and
an indexer property that allows the parameters to be added and retrieved using syntax like
myParameterPasser[name] = value.
Furthermore, two constructors are provided, one that you can specify the URL directly, and one that uses the current page's
URL as the redirect URL. Finally, there's the
PassParameters() method that, when called, sends the user to the
specified page, passing the parameters.
Passing Data Through the QueryString
Armed with this base class, creating a class to pass parameters through the querystring is a breeze - I just simply created a class that derived from
BaseParameterPasserand overrided the necessary fields. The code for this new class,
UrlParameterPasser, is shown below:
As you can see, when adding parameters to the data to be passed, a SortedList is used; on the flip-side, when the page that
has received the parameters is reading from the parameter list, the
Request.QueryString collection is used.
PassParameters() method, which is called by the sending page to initiate the call to the receiving page,
builds up the URL by enumerating the parameter values and packing them into the querystring.
With this class, the code for calling one page from another passing values in a querystring changes to very readable code:
You will notice that this code is significantly easier to read, clearer in what it is doing, and will therefore be easier to maintain. But, better still, the code is going to be less prone to typing errors, such as forgetting an ampersand or putting a quote in the wrong place. To complete the hand-off, I use the same class on the target page to pull off these parameters values. Reading them back is just as simple:
Care to Use Session Variables?
In addition to the
UrlParameterPasserclass there's also a
SessionParameterPasserthat is syntactically equivalent, but uses Session variables as the backing store as opposed to the querystring collection. This class is fairly simple and straightforward, and included in this article's download.
About the Author John Tabernik manages a web development team at Progressive Insurance's Commercial Auto division. He has developed sites for several Fortune 500 companies and owned a consulting company before joining Progressive. John can be reached at firstname.lastname@example.org.