EntityDataSource.CommandText Propriété

Référence

Définition

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

Assembly:: System.Web.Entity.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 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 correspond à 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ée :

<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. À l’instar de l’instruction SELECT, CommandText crée une projection des données d’origine qui ne peuvent pas être mises à jour.

Lorsque la CommandText propriété est affectée, les fonctionnalités de mise à jour, d’insertion et de suppression sont désactivées. Dans ce cas, les méthodes CanDelete, CanInsertet CanUpdate du contrôle associé EntityDataSourceView retournent falsetoutes .

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 qui est lié à des données à un EntityDataSource contrôle si la valeur de EnableInsert, EnableUpdateou EnableDelete a la valeur true.

Si est CommandText défini sur une requête qui retourne une projection de propriétés (par exemple, «SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p »), un DbDataRecord est retourné.

S’applique à

Partager via