Share via

Parameter.Name Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define o nome do parâmetro.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
member this.Name : string with get, set
Public Property Name As String

Valor da propriedade

String

O nome do parâmetro. O valor padrão é Empty.

Exemplos

O exemplo de código a seguir demonstra como exibir dados filtrados usando um ObjectDataSource controle para recuperar dados de um objeto de negócios de camada intermediária e um GridView controle para exibir os resultados. O exemplo de código consiste em um TextBox controle, um GridView controle, o ObjectDataSource controle e um botão Enviar. Por padrão, o TextBox controle é preenchido com o nome de um dos Northwind funcionários. O GridView controle exibe informações sobre o funcionário identificado pelo nome no TextBox controle. Para recuperar dados em outro funcionário, insira o nome completo do funcionário no TextBox controle e clique no botão.

A FilterExpression propriedade especifica uma expressão usada para filtrar os dados recuperados pela SelectMethod propriedade . Ele usa espaços reservados de parâmetro que são avaliados para os parâmetros contidos na FilterParameters coleção. Neste exemplo, o espaço reservado do parâmetro é limitado por aspas simples porque o tipo do parâmetro é um tipo de cadeia de caracteres que pode conter espaços. Se o tipo do parâmetro for um tipo numérico ou de data, as aspas delimitadoras não serão necessárias.

Este exemplo de código faz parte de um exemplo maior fornecido para a FilterExpression propriedade da ObjectDataSource classe .

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    protected void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
    {
        if (Textbox1.Text == "")
        {
            e.ParameterValues.Clear();
            e.ParameterValues.Add("FullName", "Nancy Davolio");
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

        <!-- Security Note: The ObjectDataSource uses a FormParameter,
             Security Note: which does not perform validation of input from the client. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.CS.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    Protected Sub ObjectDataSource1_Filtering(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.ObjectDataSourceFilteringEventArgs)
        If Textbox1.Text = "" Then
            e.ParameterValues.Clear()
            e.ParameterValues.Add("FullName", "Nancy Davolio")
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

        <!-- Security Note: The ObjectDataSource uses a FormParameter,
             Security Note: which does not perform validation of input from the client. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.VB.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

    </form>
  </body>
</html>

Comentários

Parameter os objetos não são necessários para ter um nome; no entanto, os controles de fonte de dados podem usar o nome do parâmetro para corresponder um Parameter objeto em uma coleção com um parâmetro em uma consulta SQL ou assinatura de método de negócios. Por exemplo, o SqlDataSource controle pode usar o nome do Parameter objeto para corresponder a um espaço reservado em uma consulta SQL parametrizada. Da mesma forma, o SqlDataSource controle pode usar o nome de um Parameter objeto na FilterParameters coleção para corresponder a um espaço reservado na FilterExpression propriedade . Em alguns casos, o nome não é usado e a ordem na qual o Parameter objeto é adicionado a uma ParameterCollection coleção é mais importante. Para obter mais informações, consulte Usando parâmetros com o controle SqlDataSource e usando parâmetros com o controle ObjectDataSource.

Se o nome do parâmetro for alterado, o OnParameterChanged método será chamado.

Aplica-se a

Confira também