Parameter.Name Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nom du paramètre.

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é

String

Le nom du paramètre. La valeur par défaut est Empty.

Exemples

L’exemple de code suivant montre comment afficher des données filtrées à l’aide d’un ObjectDataSource contrôle pour récupérer des données à partir d’un objet métier de niveau intermédiaire et d’un GridView contrôle pour afficher les résultats. L’exemple de code se compose d’un TextBox contrôle, d’un GridView contrôle, du ObjectDataSource contrôle et d’un bouton Envoyer. Par défaut, le TextBox contrôle est rempli avec le nom de l’un Northwind des employés. Le GridView contrôle affiche des informations sur l’employé identifié par le nom dans le TextBox contrôle. Pour récupérer des données sur un autre employé, entrez le nom complet de l’employé dans le TextBox contrôle, puis cliquez sur le bouton .

La FilterExpression propriété spécifie une expression utilisée pour filtrer les données récupérées par la SelectMethod propriété . Il utilise des espaces réservés de paramètres qui sont évalués en fonction des paramètres contenus dans la FilterParameters collection. Dans cet exemple, l’espace réservé de paramètre est limité par des guillemets simples, car le type du paramètre est un type de chaîne qui peut contenir des espaces. Si le type du paramètre est un type numérique ou date, les guillemets englobants ne sont pas nécessaires.

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

Remarques

Parameter il n’est pas nécessaire que les objets aient un nom ; Toutefois, les contrôles de source de données peuvent utiliser le nom du paramètre pour faire correspondre un Parameter objet dans une collection avec un paramètre dans une requête SQL ou une signature de méthode métier. Par exemple, le SqlDataSource contrôle peut utiliser le nom de l’objet Parameter pour correspondre à un espace réservé dans une requête SQL paramétrable. De même, le SqlDataSource contrôle peut utiliser le nom d’un Parameter objet dans la FilterParameters collection pour correspondre à un espace réservé dans la FilterExpression propriété . Dans certains cas, le nom n’est pas utilisé et l’ordre dans lequel l’objet Parameter est ajouté à une ParameterCollection collection est plus 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.

Si le nom du paramètre est modifié, la OnParameterChanged méthode est appelée.

S’applique à

Voir aussi

Type