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="VB" %> <SCRIPT runat="server"> Sub Page_Load(sender As Object, e As EventArgs) Dim aSqlDataSource As New SqlDataSource() ' Security Note: The SqlDataSource uses a QueryStringParameter, ' Security Note: which does not perform validation of input from the client. Dim qs1 As New QueryStringParameter("QueryStringParam1","requestfield1") aSqlDataSource.SelectParameters.Add(qs1) Dim qs3 As New QueryStringParameter("QueryStringParam3","requestfield3") aSqlDataSource.SelectParameters.Add(qs3) Dim qs2 As New QueryStringParameter("QueryStringParam2","requestField2") ' Insert aSqlDataSource.SelectParameters.Insert(1, qs2) ' Iterate through the ParameterCollection and print out the ' names of the Parameters contained by it. Dim aParameter As Parameter For Each aParameter in aSqlDataSource.SelectParameters Response.Write(aParameter.Name & "<BR>") Next End Sub ' Page_Load </SCRIPT>
.NET Framework
Available since 2.0
Available since 2.0
Show: