Parameter.Name Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el nombre del 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 de propiedad

String

El nombre del parámetro. El valor predeterminado es Empty.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar datos filtrados mediante un ObjectDataSource control para recuperar datos de un objeto de negocio de nivel intermedio y un GridView control para mostrar los resultados. El ejemplo de código consta de un TextBox control, un GridView control, el ObjectDataSource control y un botón Enviar. De forma predeterminada, el TextBox control se rellena con el nombre de uno de los Northwind empleados. El GridView control muestra información sobre el empleado identificado por el nombre en el TextBox control. Para recuperar datos en otro empleado, escriba el nombre completo del empleado en el TextBox control y haga clic en el botón .

La FilterExpression propiedad especifica una expresión utilizada para filtrar los datos recuperados por la SelectMethod propiedad . Usa marcadores de posición de parámetros que se evalúan con los parámetros contenidos en la FilterParameters colección. En este ejemplo, el marcador de posición del parámetro está limitado por comillas simples porque el tipo del parámetro es un tipo de cadena que podría contener espacios. Si el tipo del parámetro es un tipo numérico o de fecha, no se necesitan comillas de límite.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la FilterExpression propiedad de la ObjectDataSource clase .

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

Parameter No es necesario que los objetos tengan un nombre; Sin embargo, los controles de origen de datos pueden usar el nombre del parámetro para buscar coincidencias con un Parameter objeto de una colección con un parámetro en una consulta SQL o firma de método de negocio. Por ejemplo, el SqlDataSource control puede usar el nombre del Parameter objeto para que coincida con un marcador de posición en una consulta SQL con parámetros. Del mismo modo, el SqlDataSource control puede usar el nombre de un Parameter objeto de la FilterParameters colección para que coincida con un marcador de posición en la FilterExpression propiedad . En algunos casos, el nombre no se usa y el orden en el que se agrega el Parameter objeto a una ParameterCollection colección es más importante. Para obtener más información, vea Usar parámetros con el control SqlDataSource y Usar parámetros con el control ObjectDataSource.

Si se cambia el nombre del parámetro, se llama al OnParameterChanged método .

Se aplica a

Consulte también