Partager via


EntityDataSource.CommandText Propriété

Définition

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é

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 à