EntityDataSource.CommandText Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает команду 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.
Примеры
В следующем примере используется указанная команда 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>
Комментарии
Свойство CommandTextEntityDataSource элемента управления позволяет указать запрос, использующий пользовательское выражение Entity SQL. Как и инструкция SELECT, CommandText создает проекцию исходных данных, которые не обновлялись.
CommandText Если свойство назначено, обновление, вставка и удаление функциональных возможностей отключены. В этом случае методы CanDeleteCanInsertи CanUpdate связанные EntityDataSourceView элементы управления возвращаютсяfalse.
CommandText Если свойство задано, исключение возникает при ExecuteSelect вызове метода элементом управления, привязанным к EntityDataSource элементу управления, если значение EnableInsertили EnableUpdateEnableDelete задано значение true.
CommandText Если задано значение запроса, возвращающего проекцию свойств (например, "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), DbDataRecord возвращается значение.