EntityDataSource.CommandText Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ottiene o imposta un comando Entity SQL che definisce la query.

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

Valore della proprietà

String

Valore string che rappresenta la query Entity SQL.

Esempio

Nell'esempio seguente viene utilizzato il comando Entity SQL fornito per restituire una raccolta di oggetti 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>

Nell'esempio seguente viene restituita una serie proiettata di colonne:

<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>

Commenti

La CommandText proprietà del EntityDataSource controllo consente di specificare una query che utilizza un'espressione di Entity SQL personalizzata. Analogamente all'istruzione SELECT, CommandText Crea una proiezione dei dati originali che non sono aggiornabili.

Quando la CommandText proprietà è assegnata, le funzionalità di aggiornamento, inserimento ed eliminazione sono disabilitate. In questo caso, i metodi CanDelete , CanInsert e CanUpdate del controllo correlato EntityDataSourceView restituiscono tutti false .

Quando CommandText viene impostata la proprietà, viene generata un'eccezione quando il ExecuteSelect metodo viene chiamato da un controllo associato ai dati di un EntityDataSource controllo se il valore di EnableInsert , EnableUpdate o EnableDelete è impostato su true .

Se CommandText è impostato su una query che restituisce una proiezione di proprietà (ad esempio, " SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p "), DbDataRecord verrà restituito un oggetto.