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

Значение типа string, являющееся запросом Entity SQL.

Примеры

В следующем примере используется предоставляемая 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 связанного EntityDataSourceView элемента управления возвращают значение false .

Если CommandText свойство задано, исключение возникает при ExecuteSelect вызове метода элементом управления, который привязан к данным элемента управления, EntityDataSource Если для параметра EnableInsert , EnableUpdate или EnableDelete задано значение true .

Если для CommandText задан запрос, возвращающий проекцию свойств (например, " SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p "), то DbDataRecord возвращается значение.

Применяется к