Exporter (0) Imprimer
Développer tout

SqlDataSource.SelectParameters, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient la collection de paramètres qui contient les paramètres utilisés par la propriété SelectCommand de l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public ParameterCollection SelectParameters { get; }
/** @property */
public ParameterCollection get_SelectParameters ()

public function get SelectParameters () : ParameterCollection

Valeur de la propriété

ParameterCollection qui contient les paramètres utilisés par la propriété SelectCommand.

Si la propriété SelectCommand contient une requête SQL paramétrée, la collection SelectParameters contient tous les objets Parameter qui correspondent aux espaces réservés des paramètres dans la chaîne SQL.

Selon le fournisseur ADO.NET, l'ordre des paramètres dans la collection SelectParameters peut être important. Les fournisseurs System.Data.OleDb et System.Data.Odbc associent les paramètres de la collection dans l'ordre indiqué dans la requête SQL paramétrée. Le fournisseur System.Data.SqlClient, lequel est le fournisseur ADO.NET par défaut pour le contrôle SqlDataSource, associe les paramètres de la collection en faisant correspondre le nom du paramètre à un alias d'espace réservé de la requête SQL. Pour plus d'informations sur les requêtes et les commandes SQL paramétrées, consultez Utilisation de paramètres avec le contrôle SqlDataSource.

La propriété SelectParameters récupère la propriété SelectParameters contenue dans l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource.

L'exemple de code suivant illustre comment récupérer des données de la base de données Northwind dans Microsoft SQL Server en définissant la propriété SelectCommand à une requête SQL. La requête SQL est paramétrée et l'espace réservé dans la propriété SelectCommand est mis en correspondance avec l'objet ControlParameter qui est ajouté à la collection SelectParameters. Le contrôle DropDownList auquel ControlParameter est lié, agit comme un filtre pour ce qui est affiché dans le contrôle ListBox.

RemarqueRemarque

Étant donné que le paramètre est utilisé dans une clause WHERE, l'utilisation de la propriété SelectParameters dans l'exemple de code est fonctionnellement équivalente à l'utilisation des propriétés FilterExpression et FilterParameters.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
  <body>
    <form runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected>Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<HTML>
  <BODY>
    <FORM runat="server">

      <p><asp:DropDownList
          id="DropDownList1"
          runat="server"
          AutoPostBack="True">
          <asp:ListItem Selected>Sales Representative</asp:ListItem>
          <asp:ListItem>Sales Manager</asp:ListItem>
          <asp:ListItem>Vice President, Sales</asp:ListItem>
      </asp:DropDownList></p>

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <SelectParameters>
              <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </SelectParameters>
      </asp:SqlDataSource>

      <p><asp:ListBox
          id="ListBox1"
          runat="server"
          DataSourceID="SqlDataSource1"
          DataTextField="LastName">
      </asp:ListBox></p>

    </FORM>
  </BODY>
</HTML>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft