EntityDataSource.CommandText Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.Entity.dll

Recebe ou define um comando SQL Entity que define a consulta.

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

Valor de Propriedade

String

Um string valor que é a consulta SQL da Entidade.

Exemplos

O exemplo seguinte utiliza o comando SQL Entity fornecido para devolver uma coleção de objetos Produto.

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

O exemplo seguinte devolve uma série projetada de colunas:

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

Observações

A CommandText propriedade do EntityDataSource controlo permite-lhe especificar uma consulta que utiliza uma expressão SQL personalizada da Entity. Tal como a instrução SELECT, CommandText cria uma projeção dos dados originais que não é atualizável.

Quando a CommandText propriedade é atribuída, as funcionalidades de atualização, inserção e eliminação são desativadas. Neste caso, os métodos CanDelete, , e CanUpdate do controlo relacionado EntityDataSourceView todos retornam falseCanInsert.

Quando a CommandText propriedade é definida, uma exceção é lançada quando o ExecuteSelect método é chamado por um controlo que está ligado a dados a um EntityDataSource controlo se o valor de EnableInsert, EnableUpdate, ou EnableDelete for definido para true.

Se o CommandText for definido para uma consulta que devolve uma projeção de propriedades (por exemplo, "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), um será devolvido.DbDataRecord

Aplica-se a