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 属性可用于指定使用自定义实体 SQL 表达式的查询。 与 SELECT 语句一样， CommandText 创建不可更新的原始数据的投影。

CommandText分配属性时，将禁用更新、插入和删除功能。 在这种情况下，相关控件的方法 CanDelete、 CanInsert和 CanUpdate 都返回 false。EntityDataSourceView

CommandText设置 属性时，如果 、 EnableUpdate或 EnableDelete 的值设置为 true，则当数据绑定到EntityDataSource控件的EnableInsert控件调用 方法时ExecuteSelect，将引发异常。

CommandText如果将 设置为返回属性投影的查询 (例如“”SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p) ，DbDataRecord则将返回 。