Parameter.Name Propriété

Définition

Obtient ou définit le nom du paramètre.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

Valeur de propriété

Nom du paramètre.The name of the parameter. La valeur par défaut est Empty.The default value is Empty.

Exemples

L’exemple de code suivant montre comment afficher des données filtrées à ObjectDataSource l’aide d’un contrôle pour récupérer des données d’un objet métier GridView de couche intermédiaire et un contrôle pour afficher les résultats.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. L’exemple de code se compose TextBox d’un contrôle GridView , d’un ObjectDataSource contrôle, du contrôle et d’un bouton Envoyer.The code example consists of a TextBox control, a GridView control, the ObjectDataSource control, and a Submit button. Par défaut, le TextBox contrôle est rempli avec le nom de l’un Northwind des employés.By default, the TextBox control is populated with the name of one of the Northwind employees. Le GridView contrôle affiche des informations sur l’employé identifié par le nom dans TextBox le contrôle.The GridView control displays information about the employee identified by the name in the TextBox control. Pour récupérer des données sur un autre employé, entrez le nom complet de l’employé TextBox dans le contrôle, puis cliquez sur le bouton.To retrieve data on another employee, enter the full name of the employee in the TextBox control and click the button.

La FilterExpression propriété spécifie une expression utilisée pour filtrer les données récupérées SelectMethod par la propriété.The FilterExpression property specifies an expression used to filter the data retrieved by the SelectMethod property. Elle utilise des espaces réservés de paramètres qui sont évalués aux paramètres contenus dans FilterParameters la collection.It uses parameter placeholders that are evaluated to the parameters contained in the FilterParameters collection. Dans cet exemple, l’espace réservé du paramètre est délimité par des guillemets simples, car le type du paramètre est un type de chaîne qui peut contenir des espaces.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 le type du paramètre est un type numérique ou de date, les guillemets ne sont pas nécessaires.If the type of the parameter is a numeric or date type, bounding quotation marks are not needed.

Cet exemple de code fait partie d’un exemple plus complet fourni FilterExpression pour la propriété ObjectDataSource de la classe.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>

Remarques

Parameterles objets n’ont pas besoin d’un nom ; Toutefois, les contrôles de source de données peuvent utiliser le nom de Parameter paramètre pour faire correspondre un objet dans une collection à un paramètre dans une requête SQL ou une signature de méthode métier.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. Par exemple, le SqlDataSource contrôle peut utiliser le nom de l' Parameter objet pour faire correspondre un espace réservé dans une requête SQL paramétrable.For example, the SqlDataSource control can use the name of the Parameter object to match a placeholder in a parameterized SQL query. De même, le SqlDataSource contrôle peut utiliser le nom d’un Parameter objet dans la FilterParameters collection pour faire correspondre un espace réservé FilterExpression dans la propriété.Similarly, the SqlDataSource control can use the name of a Parameter object in the FilterParameters collection to match a placeholder in the FilterExpression property. Dans certains cas, le nom n’est pas utilisé et l’ordre dans lequel Parameter l’objet est ajouté à ParameterCollection une collection est plus important.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. Pour plus d’informations, consultez utilisation de paramètres avec le contrôle SqlDataSource et utilisation de paramètres avec le contrôle ObjectDataSource.For more information, see Using Parameters with the SqlDataSource Control and Using Parameters with the ObjectDataSource Control.

Si le nom du paramètre est modifié, la OnParameterChanged méthode est appelée.If the name of the parameter is changed, the OnParameterChanged method is called.

S’applique à

Voir aussi