HttpRequest.Params Property

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a combined collection of QueryString, Form, Cookies, and ServerVariables items.

public:
 property System::Collections::Specialized::NameValueCollection ^ Params { System::Collections::Specialized::NameValueCollection ^ get(); };

public System.Collections.Specialized.NameValueCollection Params { get; }

member this.Params : System.Collections.Specialized.NameValueCollection

Public ReadOnly Property Params As NameValueCollection

Property Value

NameValueCollection

A NameValueCollection object.

Examples

The following code example shows how to loop through the Params property for a page and how to display each key/value pair.

ASP.NET (C#)

<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    private void Page_Load(object sender, EventArgs e)
    {
        // Create a string to contain the paramaters'
        // information.
        string paramInfo = "";

        // Obtain a reference to the Request.Params
        // collection.
        NameValueCollection pColl = Request.Params;

        // Iterate through the collection and add
        // each key to the string variable.
        for(int i = 0; i <= pColl.Count - 1; i++)
        {
            paramInfo += "Key: " + pColl.GetKey(i) + "<br />";

            // Create a string array that contains
            // the values associated with each key.
            string[] pValues = pColl.GetValues(i);

            // Iterate through the array and add
            // each value to the string variable.
            for(int j = 0; j <= pValues.Length - 1; j++)
            {
                paramInfo += "Value:" + pValues[j] + "<br /><br />";

            }
        }

        // Set a Label's Text property to the values
        // contained in the string variable.
        lblValues.Text = paramInfo;
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:Label id="lblValues" runat="server" />
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    Private Sub Page_Load(sender As Object, e As EventArgs)

        ' Create a string to contain the paramaters'
        ' information.
        Dim paramInfo As String = ""

        Dim i, j As Integer

        ' Obtain a reference to the Request.Params
        ' collection.
        Dim pColl As NameValueCollection = Request.Params

        ' Iterate through the collection and add
        ' each key to the string variable.
        For i = 0 To pColl.Count - 1

            paramInfo += "Key: " + pColl.GetKey(i) + "<br />"

            ' Create a string array that contains
            ' the values associated with each key.
            Dim pValues() As String  = pColl.GetValues(i)

            ' Iterate through the array and add
            ' each value to the string variable.
            For j = 0 To pValues.Length - 1

                paramInfo += "Value:" + pValues(j) + "<br /><br />"

            Next j
        Next i

        ' Set a Label's Text property to the values
        ' contained in the string variable.
        lblValues.Text = paramInfo
    End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:Label id="lblValues" runat="server" />
    </form>
</body>
</html>

Remarks

Name-value pairs are added to the collection in the following order:

Query-string parameters.
Form fields.
Cookies.
Server variables.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via