Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
OrderByExpression, classe
Offre un moyen d'appliquer une expression de tri à un objet IQueryable.
System.Web.UI.WebControls.Expressions.DataSourceExpression
System.Web.UI.WebControls.Expressions.OrderByExpression
Assembly : System.Web.Extensions (dans System.Web.Extensions.dll)
Le type OrderByExpression expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
OrderByExpression | Initialise une nouvelle instance de la classe OrderByExpression. |
| Nom | Description | |
|---|---|---|
|
Context | Obtient l'instance HttpContext du contrôle propriétaire. (Hérité de DataSourceExpression.) |
|
DataField | Obtient ou définit la propriété de l'objet IQueryable en fonction de laquelle effectuer le tri. |
|
|
DataSource | Obtient l'objet source de données associé au contrôle propriétaire. (Hérité de DataSourceExpression.) |
|
|
Direction | Obtient er définit le sens du tri de l'objet source de données IQueryable. |
|
|
IsTrackingViewState | Obtient une valeur qui indique si un objet expression de source de données effectue le suivi des modifications apportées à son état d'affichage. (Hérité de DataSourceExpression.) |
|
|
Owner | Obtient le contrôle propriétaire. (Hérité de DataSourceExpression.) |
|
|
ThenByExpressions | Obtient ou définit la collection d'expressions ThenBy à appliquer après qu'une valeur OrderByExpression a été appliquée à la source de données. |
|
|
ViewState | Obtient une instance de la classe StateBag qui contient les informations sur l'état d'affichage actuel. (Hérité de DataSourceExpression.) |
| Nom | Description | |
|---|---|---|
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetQueryable | Applique une expression de tri à un objet source de données IQueryable en fonction d'une valeur DataField et d'une valeur Direction. (Substitue DataSourceExpression.GetQueryable(IQueryable).) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
LoadViewState | Charge l'état des valeurs de l'objet DataSourceExpression qui doivent être persistantes. (Hérité de DataSourceExpression.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
SaveViewState | Enregistre l'état d'affichage actuel de l'objet DataSourceExpression. (Hérité de DataSourceExpression.) |
|
|
SetContext | Définit le contexte HTTP de l'objet DataSourceExpression qui utilise le contrôle propriétaire, l'instance HttpContext et l'objet IQueryableDataSource spécifiés. (Hérité de DataSourceExpression.) |
|
|
SetDirty | Marque l'objet DataSourceExpression afin que son état soit enregistré dans l'état d'affichage. (Hérité de DataSourceExpression.) |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
|
TrackViewState | Suit les modifications apportées à l'état d'affichage de l'objet DataSourceExpression afin que les modifications puissent être stockées dans l'objet StateBag pour l'objet expression de source de données. (Hérité de DataSourceExpression.) |
| Nom | Description | |
|---|---|---|
|
IStateManager.IsTrackingViewState | En cas d'implémentation par une classe, obtient une valeur qui indique si un objet expression de source de données effectue le suivi des modifications de son état d'affichage. (Hérité de DataSourceExpression.) |
|
IStateManager.LoadViewState | En cas d'implémentation par une classe, charge l'état d'affichage précédemment enregistré de l'objet expression de source de données. (Hérité de DataSourceExpression.) |
|
|
IStateManager.SaveViewState | En cas d'implémentation par une classe, enregistre l'état d'affichage actuel de l'objet DataSourceExpression. (Hérité de DataSourceExpression.) |
|
|
IStateManager.TrackViewState | En cas d'implémentation par une classe, suit les modifications apportées à l'état d'affichage de l'objet DataSourceExpression afin que les modifications puissent être stockées dans l'objet StateBag pour l'objet expression de source de données. (Hérité de DataSourceExpression.) |
| Exception | Condition |
|---|---|
| InvalidOperationException |
La propriété DataField est null. |
La classe OrderByExpression est utilisée dans le contrôle QueryExtender pour trier des données dans l'ordre croissant ou décroissant. Le tri est effectué par le comparateur par défaut pour le type de l'élément.
Le contrôle QueryExtender prend en charge une gamme d'options que vous pouvez utiliser pour filtrer des données. Après avoir utilisé les options de filtre, vous pouvez employer l'objet OrderByExpression pour trier les données.
Vous spécifiez le champ de données à trier à l'aide de la propriété DataField. Vous spécifiez l'ordre de tri à l'aide de la propriété Direction. Après avoir appliqué l'objet OrderByExpression à la source de données, vous pouvez utiliser les expressions ThenBy pour exécuter ultérieurement un tri sur un autre champ de données.
L'exemple suivant indique comment rechercher des produits dont le nom commence par la chaîne spécifiée dans la zone de texte SearchTextBox du tableau Products de la base de données AdventureWorks. L'objet OrderByExpression trie les données par le champ de données ListPrice dans l'ordre décroissant puis par le champ ProductID dans l'ordre croissant. Le résultat de la requête retournée du contrôle LinqDataSource est affiché dans un contrôle GridView.
Cet exemple de code fait partie d'un exemple plus complet fourni dans Procédure pas à pas : filtrage des données dans une page Web à l'aide d'une syntaxe déclarative.
<form id="form1" runat="server">
Search:<asp:TextBox ID="SearchTextBox" runat="server" />
<p>
<asp:Button ID="Button1" runat="server" Text="Search" />
</p>
<asp:LinqDataSource ID="LinqDataSource1"
ContextTypeName="AdventureWorksDataContext"
TableName="Products" runat="server">
</asp:LinqDataSource>
<asp:QueryExtender runat="server" TargetControlID="LinqDataSource1">
<asp:SearchExpression SearchType="StartsWith" DataFields="Name" >
<asp:ControlParameter ControlID="SearchTextBox" />
</asp:SearchExpression>
<asp:OrderByExpression DataField="ListPrice"
Direction="Descending">
<asp:ThenBy DataField="ProductID" Direction="Ascending"/>
</asp:OrderByExpression>
</asp:QueryExtender>
<asp:GridView ID="GridView1" runat="server"
DataSourceID="LinqDataSource1" AllowPaging="True" >
</asp:GridView>
</form>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
