EntityDataSource.CommandText Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtient ou définit une commande Entity SQL qui définit la requête.

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

public string CommandText { get; set; }

member this.CommandText : string with get, set

Public Property CommandText As String

Valeur de propriété

String

Valeur string qui est la requête Entity SQL.

Exemples

L’exemple suivant utilise la commande Entity SQL fournie pour renvoyer une collection d’objets Product.

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    CommandText="SELECT value p FROM Products AS p
        WHERE p.ProductID
        BETWEEN @OrderIdMin AND @OrderIdMax"
    ConnectionString="name=AdventureWorksEntities"
    DefaultContainerName="AdventureWorksEntities" >
    <CommandParameters>
        <asp:ControlParameter Name="OrderIdMin"
            ControlID="ProductIdMin" Type="Int32"/>
        <asp:ControlParameter Name="OrderIdMax"
            ControlID="ProductIdMax" Type="Int32" />
    </CommandParameters>
</asp:EntityDataSource>

L’exemple suivant retourne une série de colonnes projetées :

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    CommandText="SELECT p.ProductID, p.ProductName, p.UnitsOnOrder
          FROM Products AS p
          WHERE p.ProductID BETWEEN @OrderIDMin AND @OrderIDMax"
          ContextTypeName="AdventureWorksModel. AdventureWorksEntities">
    <CommandParameters>
        <asp:ControlParameter Name="OrderIDMin"
                ControlID="ProductIDMinTextBox" Type="Int32"/>
        <asp:ControlParameter Name="OrderIDMax"
                ControlID="ProductIDMaxTextBox" Type="Int32" />
    </CommandParameters>
</asp:EntityDataSource>

Remarques

La CommandText propriété du EntityDataSource contrôle vous permet de spécifier une requête qui utilise une expression Entity SQL personnalisée. Comme l’instruction SELECT, CommandText crée une projection des données d’origine qui ne sont pas modifiables.

Lorsque la CommandText propriété est affectée, mettez à jour, insérez et supprimez des fonctionnalités sont désactivées. Dans ce cas, les méthodes CanDelete, CanInsertet CanUpdate du contrôle associé EntityDataSourceView retournent tous les retours false.

Lorsque la CommandText propriété est définie, une exception est levée lorsque la ExecuteSelect méthode est appelée par un contrôle lié à un EntityDataSource contrôle si la valeur EnableInsert, EnableUpdateou EnableDelete est définie sur true.

Si la CommandText 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.