LinqDataSource.OrderByParameters Propriété

Référence

Définition

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

Assembly:: System.Web.Extensions.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 la collection de paramètres utilisés pour créer la clause Order By.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ OrderByParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection OrderByParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.OrderByParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property OrderByParameters As ParameterCollection

Valeur de propriété

ParameterCollection

Paramètres utilisés pour créer la clause Order By.

Attributs: BrowsableAttribute PersistenceModeAttribute

Exemples

L'exemple suivant présente un contrôle LinqDataSource dont la valeur de la propriété AutoGenerateOrderByClause est true. Un paramètre est inclus dans la OrderByParameters collection qui commande les données en fonction du nom de propriété qu’un utilisateur sélectionne à partir d’un DropDownList contrôle.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Remarques

Le LinqDataSource contrôle utilise des paramètres dans la collection pour créer la clause Order By au moment de l’exécution OrderByParameters . En règle générale, vous définissez la AutoGenerateOrderByClause propriété true sur laquelle vous ajoutez des paramètres à la OrderByParameters collection. Lorsque la AutoGenerateOrderByClause propriété est définie sur true, chaque paramètre de la OrderByParameters collection est ajouté à la clause Order By dans la séquence spécifiée dans la OrderByParameters collection. Lorsque la AutoGenerateOrderByClause propriété est true, les paramètres n’ont pas à être nommés, car ils sont appliqués dans la séquence et ne sont pas mis en correspondance avec un espace réservé.

Si vous n’avez pas besoin de définir une valeur au moment de l’exécution dans la clause Order By, vous n’avez pas besoin d’utiliser la OrderByParameters collection. Vous pouvez définir les champs à utiliser pour commander les données dans la OrderBy propriété. Par exemple, pour retourner des valeurs à partir d’une table de base de données ordonnée par LastName, définissez OrderBy sur « LastName » sans aucun paramètre.

Vous pouvez définir des paramètres dans la OrderByParameters collection et faire correspondre les paramètres aux espaces réservés dans la OrderBy propriété, mais cette approche a une application limitée. Lorsque vous utilisez cette approche, les paramètres de la OrderByParameters collection ne peuvent pas représenter un nom de colonne. Vous pouvez définir un paramètre sur une valeur, puis comparer cette valeur aux valeurs d’une propriété. Par exemple, vous pouvez classer les données selon que les valeurs d’une propriété sont inférieures à la valeur d’exécution représentée par le paramètre.

S’applique à

Partager via