ParameterCollection.Item Property (String)


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

Gets or sets the Parameter object with the specified name in the collection.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public Parameter this[
	string name
] { get; set; }


Type: System.String

The Name of the Parameter to retrieve from the collection.

Property Value

Type: System.Web.UI.WebControls.Parameter

The Parameter with the specified name in the collection. If the Parameter is not found in the collection, the indexer returns null.

Use this indexer to get a Parameter object by name from the ParameterCollection collection, using array notation.

The following code example demonstrates how to use the Remove method and the Item indexer to remove a Parameter object from a ParameterCollection collection. In this example, several QueryStringParameter objects are added to a SelectParameters collection, one QueryStringParameter is removed from the collection, and the order of the collection is printed when the page loads.

<%@page Language="C#" %>
<SCRIPT runat="server">
private void Page_Load(object sender, EventArgs e) {

    SqlDataSource aSqlDataSource = new SqlDataSource();

    // Security Note: The SqlDataSource uses a QueryStringParameter,
    // Security Note: which does not perform validation of input from the client.

    QueryStringParameter qs1 =
        new QueryStringParameter("QueryStringParam1","requestfield1");

    QueryStringParameter qs2 =
        new QueryStringParameter("QueryStringParam2","requestfield2");

    QueryStringParameter qs3 =
        new QueryStringParameter("QueryStringParam3","requestfield3");

    // Remove the QueryStringParameter named QueryStringParameter2
    // using the Remove method and the ParameterCollection indexer
    // property.
    aSqlDataSource.SelectParameters.Remove( aSqlDataSource.SelectParameters["QueryStringParam2"] );

    // Iterate through the ParameterCollection and print out the
    // names of the Parameters contained by it.
    foreach (Parameter aParameter in aSqlDataSource.SelectParameters) {
        Response.Write(aParameter.Name + "<BR>");

.NET Framework
Available since 2.0
Return to top