EntityDataSource.Select Propriedade

Definição

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

Obtém ou define a projeção que define as propriedades a incluir nos resultados da consulta.

public:
 property System::String ^ Select { System::String ^ get(); void set(System::String ^ value); };
public string Select { get; set; }
member this.Select : string with get, set
Public Property Select As String

Valor de Propriedade

String

Os parâmetros usados para criar a cláusula ORDER BY.

Exceções

InvalidOperationException

Quando a Select propriedade especifica uma projeção de consulta e o valor de EnableUpdate, EnableDelete, ou EnableInsert é true.

Exemplos

A seguinte marcação XML utiliza a Select propriedade para especificar uma projeção com seis das propriedades do tipo Produto:

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    ConnectionString="name=AdventureWorksEntities"
    DefaultContainerName="AdventureWorksEntities"
    EntitySetName="Product" OrderBy="it.[ProductID]"
    Select="it.[ProductID], it.[Name], it.[ListPrice],
    it.[Size], it.[Style], it.[Weight]">
</asp:EntityDataSource>

O exemplo anterior de XML é o mesmo que o seguinte ObjectQuery<T> , nomeado products:

ObjectQuery<Product> products = context.Product
    .Select(it.[ProductID], it.[Name], it.[ListPrice],
      it.[Size], it.[Style], it.[Weight])
    .OrderBy("it.[ProductID]");

Observações

A Select propriedade do EntityDataSource controlo contém uma string que representa a instrução SELECT de uma consulta SQL da Entity. Isto permite-lhe projetar um conjunto específico de propriedades a partir dos objetos devolvidos pela consulta.

Esta cadeia é passada, sem modificações, para a ObjectQuery<T> que é executada pelo Entity Framework. Esta consulta é a fonte dos dados regulados pelo EntityDataSource controlo. A cadeia fornecida à Select propriedade usa o mesmo formato da cadeia que é passada ao Select método de ObjectQuery<T>. Para exemplos de como usar a cláusula SELECT para definir uma projeção para uma consulta, veja Como: Executar uma Consulta que Devolve Objetos do Tipo Anónimos.

Atualizações não são suportadas para dados projetados. Isto significa que, quando se usa a Select propriedade para especificar uma projeção, a ligação de dados limitada não suporta atualizações.

Quando defines uma projeção com paginação ativada, tens de definir a propriedade pela qual ordenar os resultados. Isto significa que, quando defines a Select propriedade para definido uma projeção e defines AutoPage para true, também deves definir a OrderBy propriedade para definir a ordem ou definir a AutoGenerateOrderByClause propriedade para true e adicionar um parâmetro ORDER BY à OrderByParameters coleção.

Select não pode ser definido se EnableUpdate, EnableDelete, ou EnableInsert estiver ativado.

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

Aplica-se a