EntityDataSource.CommandText Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Entity.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define um comando do Entity SQL 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 da propriedade

String

Um valor string que é a consulta do Entity SQL.

Exemplos

O exemplo a seguir usa o comando Entity SQL fornecido para retornar uma coleção de objetos 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>

O exemplo a seguir retorna 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>

Comentários

A CommandText Propriedade do EntityDataSource controle permite que você especifique uma consulta que usa uma expressão de Entity SQL personalizada. Assim como a instrução SELECT, o CommandText cria uma projeção dos dados originais que não são atualizáveis.

Quando a CommandText propriedade é atribuída, as funcionalidades atualizar, inserir e excluir estão desabilitadas. Nesse caso, os métodos CanDelete , CanInsert e CanUpdate do EntityDataSourceView controle relacionado todos retornam false .

Quando a CommandText propriedade é definida, uma exceção é lançada quando o ExecuteSelect método é chamado por um controle que é vinculado a um EntityDataSource controle se o valor de EnableInsert , EnableUpdate ou EnableDelete é definido como true .

Se o CommandText for definido como uma consulta que retorna uma projeção de Propriedades (por exemplo, " SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p "), um DbDataRecord será retornado.

Aplica-se a

Partilhar via