LinqDataSource Classe

Definição

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource

public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource

Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource

Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource

Herança

Object

Control

DataSourceControl

LinqDataSource

Herança

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Atributos

ToolboxBitmapAttribute

Implementações

IDynamicDataSource IDataSource

Exemplos

O exemplo seguinte mostra um LinqDataSource controlo que recupera dados de uma classe de entidade chamada Products. A classe de entidade poderia ter sido gerada usando o O/R Designer ou a utilidade SqlMetal.exe. A Where propriedade está definida para devolver apenas registos que tenham um valor superior a 50.Price Um GridView controlo está vinculado ao LinqDataSource controlo para exibir os dados.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

O exemplo seguinte mostra um LinqDataSource controlo que permite aos utilizadores atualizar, eliminar e inserir registos na fonte de dados. Um controlo está ligado ao LinqDataSource controlo e permite aos DetailsView utilizadores ver e modificar os dados. Note que não são necessários comandos SQL para selecionar, atualizar, eliminar ou inserir os registos.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

O exemplo seguinte mostra um gestor de eventos para o Selecting evento que define o objeto de dados com base num valor na página Web.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}

Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

O exemplo seguinte mostra um LinqDataSource controlo configurado para agrupar por duas colunas. A Key propriedade refere-se a um objeto que tem duas propriedades, ProductCategory e Color. O objeto representado por It é renomeado (aliasado) para Products. O objeto renomeado Products contém uma coleção dos registos individuais num agrupamento. Cada instância conterá todas as colunas da Products tabela.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

O exemplo seguinte mostra dois ListView controlos que mostram os dados do LinqDataSource controlo no exemplo anterior. Um ListView controlo mostra os dados agrupados e o outro ListView controlo mostra os nomes individuais dos produtos que pertencem a esse grupo. A propriedade do DataSource controlo limitado a dados aninhado é definida como Products, que é o alias do It objeto.

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>

<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Observações

Neste tópico:

• Introdução

• Ordem de Operações

• Dados de Ordenação

• Agrupamento de Dados

• Modificações de Dados

• Avaliação de Valores em Tempo de Execução

• Trabalhar com Procedimentos Armazenados

• Sintaxe declarativa

Introduction

Language-Integrated Consulta (LINQ) é uma sintaxe de consulta que define um conjunto de operadores de consulta que permitem que operações de percurso, filtro e projeção sejam expressas de forma declarativa em qualquer linguagem de programação baseada em .NET. O objeto de dados pode ser uma coleção de dados em memória ou um objeto que representa dados de uma base de dados. Pode recuperar ou modificar os dados sem ter de escrever comandos SQL para cada operação.

O controlo LinqDataSource permite-lhe usar o LINQ numa página Web ASP.NET definindo propriedades no texto de marcação. O LinqDataSource controlo utiliza LINQ para SQL para gerar automaticamente os comandos de dados. Para mais informações sobre LINQ para SQL, veja LINQ para SQL.

Quando está a recuperar dados de uma coleção de dados em memória, define a ContextTypeName propriedade para a classe que contém a recolha de dados. Define a TableName propriedade para a propriedade ou campo que devolve a recolha de dados. Por exemplo, pode ter uma classe chamada Person que contém uma propriedade chamada FavoriteCities que devolve um array de valores de cadeia. Nesse caso, define a ContextTypeName propriedade como Person e define a TableName propriedade para FavoriteCities.

Quando está a consultar uma base de dados, deve primeiro criar classes de entidade que representem a base de dados e as suas tabelas. Pode usar o Object Relational Designer ou a utilidade SqlMetal.exe para gerar estas classes. Depois defines a ContextTypeName propriedade para a classe que representa a base de dados e defines a TableName propriedade para a propriedade que representa a tabela da base de dados.

Ordem de Operações

O LinqDataSource controlo aplica as operações de dados na seguinte ordem:

1. Onde (especificar que registos de dados devolver).

2. Ordenar por (ordenar).

3. Agrupar por (registos de dados agregados que partilham valores).

4. Ordenar os grupos por (ordenar os dados agrupados).

5. Selecionar (especificar quais os campos ou propriedades a devolver).

6. Auto-ordenar (ordenar registos de dados por uma propriedade selecionada pelo utilizador).

7. Página automática (recuperar um subconjunto de registos de dados selecionados pelo utilizador).

Pode adicionar condições à Where propriedade para filtrar os registos de dados que são devolvidos de uma consulta. Se a Where propriedade não estiver definida, o controlo LinqDataSource recupera todos os registos do objeto de dados.

Dados de Ordenação

Usas a OrderBy propriedade para especificar os nomes das propriedades a partir dos dados devolvidos para ordenar.

Agrupamento de dados

Usas a GroupBy propriedade para especificar quais as propriedades que são usadas para consolidar registos de dados que têm os mesmos valores. Quando agrupa dados, pode incluir Key e It, que são propriedades criadas dinamicamente, na Select propriedade. A Key propriedade refere-se aos valores na propriedade ou propriedades que foram usados para agrupar os dados. Por exemplo, se agrupar por uma propriedade chamada Category, a Key propriedade conterá todos os valores únicos da Category propriedade. A It propriedade refere-se a uma coleção de registos individuais num agrupamento de dados. Pode iterar sobre a It propriedade para recuperar os registos individuais que foram consolidados na operação de agrupamento. Por exemplo, se agrupar por uma propriedade chamada Category, a It propriedade contém todos os registos individuais que partilham um valor comum na Category propriedade.

Usas a OrderGroupsBy propriedade para especificar as propriedades a usar para ordenar os dados agrupados. Quando agrupa dados, a OrderBy propriedade especifica como os registos individuais dentro dos dados agrupados são organizados.

Por defeito, o controlo LinqDataSource recupera valores para todas as propriedades de um objeto de dados. Usas a Select propriedade para especificar quais propriedades devolver se quiseres trabalhar com um subconjunto de propriedades disponíveis. A operação Selecionar é aplicada após as operações Onde, Ordem Por, e Agrupar Per. Portanto, se criar um nome aliasado numa cláusula Select, o alias não está disponível nas outras cláusulas.

Modificações de Dados

Pode especificar se as modificações de dados são ativadas usando as EnableDeletepropriedades , EnableInsert, e EnableUpdate . A interface de utilizador para modificar dados a partir de um LinqDataSource controlo é normalmente fornecida através de um controlo vinculado a dados, como um DetailsView controlo. Além de definir EnableDelete, EnableInsert, ou EnableUpdate para true, são necessárias as seguintes condições para permitir modificações automáticas de dados:

• A Select propriedade não pode ter um valor atribuído.

• A GroupBy propriedade não pode ter um valor atribuído.

• A classe atribuída à ContextTypeName propriedade deve derivar de DataContext.

• A propriedade atribuída à TableName propriedade deve derivar de Table<TEntity>.

Pode restringir quais as propriedades que são exibidas num controlo data-bound de duas formas. Pode definir a Select propriedade para um subconjunto de propriedades, ou pode definir os campos para um controlo data-bound adicionando DataControlField controlos. No entanto, se definires a Select propriedade, significa que as operações automáticas de atualização, inserção e eliminação não podem ser ativadas. Se quiser ativar modificações automáticas de dados enquanto trabalha com um subconjunto de propriedades disponíveis, não defina a Select propriedade. Em vez disso, recupere todas as propriedades do objeto de dados e gere quais são exibidas usando o controlo data-bound. Quando usa o DetailsView controlo ou o GridView controlo, também deve definir as AutoGenerateRows propriedades ou AutoGenerateColumns para false. Isto impede que o controlo vinculado aos dados inclua automaticamente botões para editar e eliminar os dados. Quaisquer valores que não sejam exibidos no controlo ligado a dados são armazenados no estado de visualização. São transmitidos inalterados para a fonte de dados quando a atualização de dados é realizada.

Avaliação de Valores em Tempo de Execução

Se tiver de avaliar valores em tempo de execução para ordenar, filtrar ou agrupar valores, pode adicionar parâmetros às WhereParameterscoleções , GroupByParameters, OrderGroupsByParameters, ou OrderByParameters .

Se quiseres especificar valores por defeito, podes adicionar parâmetros à InsertParameters coleção.

Se quiser examinar ou modificar valores antes da execução da operação de dados, pode tratar dos Deletingeventos, Inserting, Selecting, ou Updating . Também pode gerir estes eventos para cancelar a operação de dados ou para examinar erros de validação que ocorreram ao definir propriedades na classe de dados com base na entrada do utilizador.

Para examinar os valores após a conclusão da operação de dados, trate os Deleted, Inserted, Selected, ou Updated eventos.

Trabalhar com Procedimentos Armazenados

Utiliza-se o LinqDataSource controlo para recuperar dados de um procedimento armazenado, criando um gestor de eventos para o Selecting evento. No gestor de eventos, chamas o método na classe de contexto de dados que representa o procedimento armazenado e defines o resultado para a Result propriedade do LinqDataSourceSelectEventArgs objeto. Se quiser ativar operações automáticas de atualização, inserção e eliminação dos dados, o tipo devolvido pelo método deve corresponder ao tipo especificado na TableName propriedade. Para mais informações sobre a criação de métodos de contexto de dados, veja Como: Criar métodos DataContext mapeados para procedimentos e funções armazenados (O/R Designer).

Sintaxe declarativa

<asp:LinqDataSource
    AutoGenerateOrderByClause="True|False"
    AutoGenerateWhereClause="True|False"
    AutoPage="True|False"
    AutoSort="True|False"
    ContextTypeName="string"
    EnableDelete="True|False"
    EnableInsert="True|False"
    EnableTheming="True|False"
    EnableUpdate="True|False"
    EnableViewState="True|False"
    GroupBy="string"
    ID="string"
    OnContextCreated="ContextCreated event handler"
    OnContextCreating="ContextCreating event handler"
    OnContextDisposing="ContextDisposing event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    OrderBy="string"
    runat="server"
    Select="string"
    SkinID="string"
    StoreOriginalValuesInViewState="True|False"
    TableName="string"
    Visible="True|False"
    Where="string"
>
        <GroupByParameters />
        <InsertParameters />
        <OrderByParameters />
        <SelectParameters />
        <WhereParameters />
</asp:LinqDataSource>

Ver também

• LINQ para SQL