ParameterCollection.Item[] Propriedade

Definição

Obtém ou define o objeto Parameter na coleção.

Sobrecargas

Item[String]

Obtém ou define o objeto Parameter com o nome especificado na coleção.

Item[Int32]

Obtém ou define o objeto Parameter no índice especificado na coleção.

Item[String]

Obtém ou define o objeto Parameter com o nome especificado na coleção.

public:
 property System::Web::UI::WebControls::Parameter ^ default[System::String ^] { System::Web::UI::WebControls::Parameter ^ get(System::String ^ name); void set(System::String ^ name, System::Web::UI::WebControls::Parameter ^ value); };
public System.Web.UI.WebControls.Parameter this[string name] { get; set; }
member this.Item(string) : System.Web.UI.WebControls.Parameter with get, set
Default Public Property Item(name As String) As Parameter

Parâmetros

name
String

O Name do Parameter a ser recuperado da coleção.

Valor da propriedade

Parameter

Com Parameter o nome especificado na coleção. Se não Parameter for encontrado na coleção, o indexador retornará null.

Exemplos

O exemplo de código a seguir demonstra como usar o Remove método e o Item[] indexador para remover um Parameter objeto de uma ParameterCollection coleção. Neste exemplo, vários QueryStringParameter objetos são adicionados a uma SelectParameters coleção, um QueryStringParameter é removido da coleção e a ordem da coleção é impressa quando a página é carregada.

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

    QueryStringParameter qs3 =
        new QueryStringParameter("QueryStringParam3","requestfield3");
    aSqlDataSource.SelectParameters.Add(qs3);

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

    Dim qs3 As New QueryStringParameter("QueryStringParam3","requestfield3")
    aSqlDataSource.SelectParameters.Add(qs3)

    ' 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.
    Dim aParameter As Parameter
    For Each aParameter in aSqlDataSource.SelectParameters
        Response.Write(aParameter.Name & "<BR>")
    Next
End Sub ' Page_Load
</SCRIPT>

Comentários

Use esse indexador para obter um Parameter objeto pelo nome da coleção, usando notação ParameterCollection de matriz.

Confira também

Aplica-se a

Item[Int32]

Obtém ou define o objeto Parameter no índice especificado na coleção.

public:
 property System::Web::UI::WebControls::Parameter ^ default[int] { System::Web::UI::WebControls::Parameter ^ get(int index); void set(int index, System::Web::UI::WebControls::Parameter ^ value); };
public System.Web.UI.WebControls.Parameter this[int index] { get; set; }
member this.Item(int) : System.Web.UI.WebControls.Parameter with get, set
Default Public Property Item(index As Integer) As Parameter

Parâmetros

index
Int32

O índice da Parameter a ser recuperada da coleção.

Valor da propriedade

Parameter

O Parameter índice especificado na coleção.

Comentários

Use esse indexador para obter um Parameter objeto por sua localização na ParameterCollection coleção.

Confira também

Aplica-se a