Export (0) Print
Expand All

ParameterCollection.Item Property (String)

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

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft