Parameter.Name Propiedad

Definición

Obtiene o establece el nombre del parámetro.Gets or sets the name of the parameter.

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 de propiedad

Nombre del parámetro.The name of the parameter. El valor predeterminado es Empty.The default value is Empty.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar los datos filtrados usando un ObjectDataSource control para recuperar datos de un objeto comercial de nivel intermedio y un GridView control para mostrar los resultados.The following code example demonstrates how to display filtered data using an ObjectDataSource control to retrieve data from a middle-tier business object and a GridView control to display the results. El ejemplo de código consta de TextBox un control, GridView un control, ObjectDataSource el control y un botón de envío.The code example consists of a TextBox control, a GridView control, the ObjectDataSource control, and a Submit button. De forma predeterminada, TextBox el control se rellena con el nombre de uno de Northwind los empleados.By default, the TextBox control is populated with the name of one of the Northwind employees. El GridView control muestra información sobre el empleado identificado por el nombre TextBox del control.The GridView control displays information about the employee identified by the name in the TextBox control. Para recuperar los datos de otro empleado, escriba el nombre completo del empleado en el TextBox control y haga clic en el botón.To retrieve data on another employee, enter the full name of the employee in the TextBox control and click the button.

La FilterExpression propiedad especifica una expresión utilizada para filtrar los datos recuperados SelectMethod por la propiedad.The FilterExpression property specifies an expression used to filter the data retrieved by the SelectMethod property. Usa marcadores de posición de parámetro que se evalúan como los parámetros contenidos FilterParameters en la colección.It uses parameter placeholders that are evaluated to the parameters contained in the FilterParameters collection. En este ejemplo, el marcador de posición de parámetro se delimita entre comillas simples porque el tipo del parámetro es un tipo de cadena que puede contener espacios.In this example, the parameter placeholder is bounded by single quotation marks because the type of the parameter is a string type that might contain spaces. Si el tipo del parámetro es un tipo numérico o de fecha, no se necesitan comillas de límite.If the type of the parameter is a numeric or date type, bounding quotation marks are not needed.

Este ejemplo de código forma parte de un ejemplo más extenso proporcionado FilterExpression para la propiedad ObjectDataSource de la clase.This code example is part of a larger example provided for the FilterExpression property of the ObjectDataSource class.

<%@ 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>

Comentarios

Parameterno es necesario que los objetos tengan un nombre; sin embargo, los controles de origen de datos pueden utilizar el nombre Parameter del parámetro para que coincida con un objeto de una colección con un parámetro en una consulta SQL o una firma de método empresarial.Parameter objects are not required to have a name; however, data source controls might use the parameter name to match a Parameter object in a collection with a parameter in a SQL query or business method signature. Por ejemplo, el SqlDataSource control puede usar el nombre Parameter del objeto para hacer coincidir un marcador de posición en una consulta SQL con parámetros.For example, the SqlDataSource control can use the name of the Parameter object to match a placeholder in a parameterized SQL query. Del mismo modo SqlDataSource , el control puede usar el nombre Parameter de un objeto FilterParameters en la colección para que coincida con FilterExpression un marcador de posición en la propiedad.Similarly, the SqlDataSource control can use the name of a Parameter object in the FilterParameters collection to match a placeholder in the FilterExpression property. En algunos casos, el nombre no se utiliza y el orden en el que Parameter se agrega el objeto a ParameterCollection una colección es más importante.In some cases, the name is not used and the order in which the Parameter object is added to a ParameterCollection collection is more important. Para obtener más información, vea usar parámetros con el control SqlDataSource y usar parámetros con el control ObjectDataSource.For more information, see Using Parameters with the SqlDataSource Control and Using Parameters with the ObjectDataSource Control.

Si se cambia el nombre del parámetro, se llama OnParameterChanged al método.If the name of the parameter is changed, the OnParameterChanged method is called.

Se aplica a

Consulte también: