ParameterCollection.Insert Method (Int32, Parameter)
.NET Framework (current version)
Inserts the specified Parameter object into the ParameterCollection collection at the specified index.
Assembly: System.Web (in System.Web.dll)
Parameters
- index
-
Type:
System.Int32
The zero-based index at which the Parameter is inserted.
- parameter
-
Type:
System.Web.UI.WebControls.Parameter
The Parameter to insert.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | index is less than zero. -or- index is greater than Count. |
The following code example demonstrates how to use the Insert method to add a Parameter object to a ParameterCollection collection at a specific location. In this example, several QueryStringParameter objects are added to a SelectParameters collection, one QueryStringParameter is inserted into 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"); aSqlDataSource.SelectParameters.Add(qs1); QueryStringParameter qs3 = new QueryStringParameter("QueryStringParam3","requestfield3"); aSqlDataSource.SelectParameters.Add(qs3); // Insert aSqlDataSource.SelectParameters.Insert(1, new QueryStringParameter("QueryStringParam2", "requestField2") ); // 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>"); } } </SCRIPT>
.NET Framework
Available since 2.0
Available since 2.0
Show: