EntityDataSource.Select Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtient ou définit la projection qui définit les propriétés à inclure dans les résultats de la requête.

public:
 property System::String ^ Select { System::String ^ get(); void set(System::String ^ value); };

public string Select { get; set; }

member this.Select : string with get, set

Public Property Select As String

Valeur de propriété

String

Paramètres utilisés pour créer la clause ORDER BY.

Exceptions

InvalidOperationException

Lorsque la Select propriété spécifie une projection de requête et la valeur de EnableUpdate, EnableDeleteou EnableInsert est true.

Exemples

Le balisage XML suivant utilise la Select propriété pour spécifier une projection avec six des propriétés du type Produit :

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    ConnectionString="name=AdventureWorksEntities"
    DefaultContainerName="AdventureWorksEntities"
    EntitySetName="Product" OrderBy="it.[ProductID]"
    Select="it.[ProductID], it.[Name], it.[ListPrice],
    it.[Size], it.[Style], it.[Weight]">
</asp:EntityDataSource>

L’exemple XML précédent est identique au nom productssuivant ObjectQuery<T> :

ObjectQuery<Product> products = context.Product
    .Select(it.[ProductID], it.[Name], it.[ListPrice],
      it.[Size], it.[Style], it.[Weight])
    .OrderBy("it.[ProductID]");

Remarques

La Select propriété du EntityDataSource contrôle contient une chaîne qui représente l’instruction SELECT d’une requête Entity SQL. Cela vous permet de projeter un ensemble de propriétés spécifié à partir des objets retournés par la requête.

Cette chaîne est passée, sans modification, à celle ObjectQuery<T> exécutée par Entity Framework. Cette requête est la source des données réglementées par le EntityDataSource contrôle. La chaîne fournie à la Select propriété utilise le même format que la chaîne passée à la Select méthode de ObjectQuery<T>. Pour obtenir des exemples d’utilisation de la clause SELECT pour définir une projection pour une requête, consultez Guide pratique pour exécuter une requête qui renvoie des objets de type anonyme.

Les mises à jour ne sont pas prises en charge pour les données projetées. Cela signifie que lorsque vous utilisez la Select propriété pour spécifier une projection, la liaison de données liée ne prend pas en charge les mises à jour.

Lorsque vous définissez une projection avec pagination activée, vous devez définir la propriété par laquelle classer les résultats. Cela signifie que lorsque vous définissez la Select propriété pour définir une projection et que vous avez AutoPage défini truesur , vous devez également définir la OrderBy propriété pour définir l’ordre ou définir la AutoGenerateOrderByClause propriété sur true et ajouter un paramètre ORDER BY à la OrderByParameters collection.

Select ne peut pas être défini si EnableUpdate, EnableDeleteou EnableInsert est activé.

Si la Select valeur est définie sur une requête qui retourne une projection de propriétés (par exemple, SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p), une DbDataRecord requête est retournée.