ParameterCollection.RemoveAt メソッド

.NET Framework クラス ライブラリ リファレンス

ParameterCollection.RemoveAt メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したインデックス位置にある Parameter オブジェクトを ParameterCollection コレクションから削除します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub RemoveAt ( _
    index As Integer _
)

Visual Basic (使用法)

Dim instance As ParameterCollection
Dim index As Integer

instance.RemoveAt(index)

C#

public void RemoveAt (
    int index
)

C++

public:
void RemoveAt (
    int index
)

J#

public void RemoveAt (
    int index
)

JScript

public function RemoveAt (
    index : int
)

パラメータ

index

削除する Parameter のインデックス。

解説

RemoveAt メソッドを使用して、指定したインデックス位置にある Parameter オブジェクトをコレクションから削除します。

使用例

RemoveAt メソッドを使用して、ParameterCollection コレクションの指定した位置から Parameter オブジェクトを削除する方法を次のコード例に示します。この例では、複数の QueryStringParameter オブジェクトを SelectParameters コレクションに追加しています。コレクションから QueryStringParameter オブジェクトが 1 つ削除され、ページの読み込み時にコレクションの順序が出力されます。

Visual Basic

<%@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 qs2 As New QueryStringParameter("QueryStringParam2"
,"requestfield2")
    aSqlDataSource.SelectParameters.Add(qs2)

    ' Insert another QueryStringParameter with the same name as the
 previous parameter.
    Dim qs3 As New QueryStringParameter("QueryStringParam2"
,"requestfield3")
    aSqlDataSource.SelectParameters.Add(qs3)

    ' There are two parameters named QueryStringParam3. Use the
    ' RemoveAt method to remove the last element from the collection.
    aSqlDataSource.SelectParameters.RemoveAt( (aSqlDataSource.SelectParameters.Count
 - 1) )

    ' 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>")
        Dim qsptemp As QueryStringParameter
 = CType(aParameter, QueryStringParameter)
        Response.Write("QueryStringField is " &
 qsptemp.QueryStringField & "<BR>")
    Next
End Sub ' Page_Load
</SCRIPT>

C#

<%@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("QueryStringParam2"
,"requestfield2");

    aSqlDataSource.SelectParameters.Add(qs3);

    // Insert another QueryStringParameter with the same name as the
 previous parameter.
    aSqlDataSource.SelectParameters.Add( new QueryStringParameter("QueryStringParameter2","requestfield3")
 );

    // There are two parameters named QueryStringParam3. Use the
    // RemoveAt method to remove the last element from the collection.
    aSqlDataSource.SelectParameters.RemoveAt( (aSqlDataSource.SelectParameters.Count
 - 1) );

    // 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>");
        QueryStringParameter qsptemp = (QueryStringParameter) aParameter;
        Response.Write("QueryStringField is " + qsptemp.QueryStringField
 + "<BR>");
    }
}
</SCRIPT>

J#

<%@page Language="VJ#" %>
<SCRIPT runat="server">
private void Page_Load(Object sender, System.EventArgs
 e)
{
    SqlDataSource aSqlDataSource = new SqlDataSource();
    
    QueryStringParameter qs1 = 
        new QueryStringParameter("QueryStringParam1"
,"requestfield1");

    aSqlDataSource.get_SelectParameters().Add(qs1);
        
    QueryStringParameter qs3 = 
        new QueryStringParameter("QueryStringParam2"
,"requestfield2");
        
    aSqlDataSource.get_SelectParameters().Add(qs3);
    
    // Insert another QueryStringParameter with the same name as the
 previous
    // parameter.
    aSqlDataSource.get_SelectParameters().Add( new QueryStringParameter(
        "QueryStringParameter2","requestfield3") );    
           
    // There are two parameters named QueryStringParam3. Use the 
    // RemoveAt method to remove the last element from the collection.
  
    aSqlDataSource.get_SelectParameters().RemoveAt( 
        (aSqlDataSource.get_SelectParameters().get_Count() - 1) );
        
    // Iterate through the ParameterCollection and print out the 
    // names of the Parameters contained by it.
    for(int iCtr =0; iCtr < aSqlDataSource.get_SelectParameters().
        get_Count(); iCtr++) {
            Parameter aParameter = aSqlDataSource.get_SelectParameters().
                get_Item(iCtr);
            get_Response().Write(aParameter.get_Name() + "<BR>");
            QueryStringParameter qsptemp = (QueryStringParameter) aParameter;
                get_Response().Write("QueryStringField is " 
                + qsptemp.get_QueryStringField() + "<BR>");

    }
} //Page_Load
</SCRIPT>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ParameterCollection クラス
ParameterCollection メンバ
System.Web.UI.WebControls 名前空間
Parameter クラス
Add
RemoveAt