EntityDataSource.CommandText 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Entity.dll

取得或設定定義查詢的 Entity SQL 命令。

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

屬性值

String

本身為 Entity SQL 查詢的 string 值。

範例

下列範例會使用提供的 Entity SQL 命令傳回 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>

下列範例會傳回投影的資料行系列：

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

備註

控制項 CommandText 的 EntityDataSource 屬性可讓您指定使用自訂 Entity SQL 運算式的查詢。 如同 SELECT 語句， CommandText 建立無法更新的原始資料投影。

CommandText指派屬性時，會停用更新、插入和刪除功能。 在此情況下，相關控制項的方法 CanDelete 、 CanInsert 和 CanUpdate 全都會傳回 false 。 EntityDataSourceView

CommandText設定 屬性時，如果 、 或 EnableDelete 的值 EnableInsertEnableUpdate 設定 true 為 ，則由系結至 EntityDataSource 控制項之控制項的 控制項呼叫 方法時 ExecuteSelect ，會擲回例外狀況。

CommandText如果 設定為傳回屬性投影的查詢 (例如 「 SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p 」) ， DbDataRecord 則會傳回 。