ParameterCollection.Insert(Int32, Parameter) 方法

定义

将指定的 Parameter 对象插入到 ParameterCollection 集合中的指定索引位置。Inserts the specified Parameter object into the ParameterCollection collection at the specified index.

public:
 void Insert(int index, System::Web::UI::WebControls::Parameter ^ parameter);
public void Insert (int index, System.Web.UI.WebControls.Parameter parameter);
member this.Insert : int * System.Web.UI.WebControls.Parameter -> unit
Public Sub Insert (index As Integer, parameter As Parameter)

参数

index
Int32

插入 Parameter 时所在的从零开始的索引。The zero-based index at which the Parameter is inserted.

parameter
Parameter

要插入的 ParameterThe Parameter to insert.

例外

index 小于零。index is less than zero.

- 或 --or-

index 大于 Countindex is greater than Count.

示例

下面的代码示例演示如何使用 Insert 方法将 Parameter 对象添加到 ParameterCollection 集合中的特定位置。The following code example demonstrates how to use the Insert method to add a Parameter object to a ParameterCollection collection at a specific location. 在此示例中, QueryStringParameter 将多个对象添加到 SelectParameters 集合中,将一个对象 QueryStringParameter 插入到集合中,并在加载页面时打印集合的顺序。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>
<%@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>

适用于

另请参阅