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 usato 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 usa un'espressione ENTITY SQL personalizzata. Analogamente all'istruzione SELECT, CommandText crea una proiezione dei dati originali che non sono aggiornabili.

Quando la CommandText proprietà viene assegnata, le funzionalità di aggiornamento, inserimento ed eliminazione sono disabilitate. In questo caso, i metodi CanDelete, CanInserte CanUpdate del controllo correlato EntityDataSourceView restituiscono falsetutti .

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

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