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 a seguir mostra um LinqDataSource controle que recupera dados de uma classe de entidade chamada Products. A classe de entidade pode ter sido gerada usando o Designer O/R ou o utilitário SqlMetal.exe. A Where propriedade é definida para retornar apenas registros que têm um valor na Price propriedade maior que 50. Um GridView controle é associado ao LinqDataSource controle 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 a seguir mostra um LinqDataSource controle que permite que os usuários atualizem, excluam e insiram registros na fonte de dados. Um DetailsView controle é associado ao LinqDataSource controle e permite que os usuários vejam e modifiquem os dados. Observe que nenhum comando SQL é necessário para selecionar, atualizar, excluir ou inserir os registros.

<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 a seguir mostra um manipulador de eventos para o Selecting evento que define o objeto de dados com base em um valor na página da 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 a seguir mostra um LinqDataSource controle configurado para agrupar por duas colunas. A Key propriedade faz referência a um objeto que tem duas propriedades ProductCategory e Color. O objeto representado por It é renomeado (aliased) para Products. O objeto renomeado Products contém uma coleção de registros individuais em um 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 a seguir mostra dois ListView controles que exibem os dados do LinqDataSource controle no exemplo anterior. Um ListView controle exibe os dados agrupados e o outro ListView exibe os nomes individuais de produtos que pertencem a esse grupo. A propriedade do DataSource controle aninhado associado a dados é 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>

Comentários

Neste tópico:

• Introdução

• Ordem das operações

• Ordenando dados

• Agrupamento de dados

• Modificações de dados

• Avaliando valores em tempo de execução

• Trabalhando com procedimentos armazenados

• Sintaxe declarativa

Introdução

Language-Integrated Query (LINQ) é uma sintaxe de consulta que define um conjunto de operadores de consulta que permitem que operações de passagem, 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 na memória ou um objeto que representa dados de um banco de dados. Você pode recuperar ou modificar os dados sem precisar gravar comandos SQL para cada operação.

O LinqDataSource controle permite que você use LINQ em uma página da Web ASP.NET definindo propriedades no texto de marcação. O LinqDataSource controle usa LINQ to SQL para gerar automaticamente os comandos de dados. Para obter mais informações sobre LINQ to SQL, consulte LINQ to SQL.

Quando você estiver recuperando dados de uma coleta de dados na memória, defina a ContextTypeName propriedade para a classe que contém a coleta de dados. Defina a TableName propriedade como a propriedade ou o campo que retorna a coleta de dados. Por exemplo, você pode ter uma classe nomeada Person que contém uma propriedade nomeada FavoriteCities que retorna uma matriz de valores de cadeia de caracteres. Nesse caso, você define a ContextTypeName propriedade Person e define a TableName propriedade como FavoriteCities.

Ao consultar um banco de dados, primeiro você deve criar classes de entidade que representam o banco de dados e suas tabelas. Você pode usar o Designer Relacional de Objeto ou o utilitário SqlMetal.exe para gerar essas classes. Em seguida, defina a ContextTypeName propriedade para a classe que representa o banco de dados e defina a TableName propriedade como a propriedade que representa a tabela de banco de dados.

Ordem das operações

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

1. Onde (especifique quais registros de dados devem ser retornados).

2. Order By (sort).

3. Agrupar por (agregar registros de dados que compartilham valores).

4. Ordenar Grupos por (classificar dados agrupados).

5. Selecione (especifique quais campos ou propriedades devem ser retornados).

6. Classificação automática (classificar registros de dados por uma propriedade selecionada pelo usuário).

7. Página automática (recuperar um subconjunto de registros de dados que foram selecionados pelo usuário).

Você pode adicionar condições à Where propriedade para filtrar os registros de dados retornados de uma consulta. Se a Where propriedade não estiver definida, o LinqDataSource controle recuperará todos os registros do objeto de dados.

Ordenando dados

Você usa a OrderBy propriedade para especificar os nomes das propriedades dos dados retornados para classificar.

Agrupar dados

Você usa a GroupBy propriedade para especificar quais propriedades são usadas para consolidar registros de dados que têm os mesmos valores. Ao agrupar dados, você 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 usadas para agrupar os dados. Por exemplo, se você agrupar por uma propriedade nomeada Category, a Key propriedade conterá todos os valores exclusivos na Category propriedade. A It propriedade refere-se a uma coleção de registros individuais em um agrupamento de dados. Você pode iterar sobre a It propriedade para recuperar os registros individuais que foram consolidados na operação de agrupamento. Por exemplo, se você agrupar por uma propriedade nomeada Category, a It propriedade conterá todos os registros individuais que compartilham um valor comum na Category propriedade.

Use a OrderGroupsBy propriedade para especificar as propriedades a serem usadas para classificar os dados agrupados. Quando você agrupa dados, a OrderBy propriedade especifica como os registros individuais dentro dos dados agrupados são classificados.

Por padrão, o LinqDataSource controle recupera valores para todas as propriedades de um objeto de dados. Use a Select propriedade para especificar quais propriedades retornar se desejar trabalhar com um subconjunto de propriedades disponíveis. A operação Selecionar é aplicada após as operações Where, Order By e Group By. Portanto, se você criar um nome de alias em uma cláusula Select, o alias não estará disponível nas outras cláusulas.

Modificações de dados

Você pode especificar se as modificações de dados estão habilitadas usando as propriedades e EnableUpdate as EnableDeleteEnableInsertpropriedades. A interface do usuário para modificar dados de um LinqDataSource controle normalmente é fornecida por meio de um controle associado a dados, como um DetailsView controle. Além de definir EnableDelete, EnableInsertou EnableUpdate para true, as seguintes condições são necessárias para habilitar modificações automáticas de dados:

• A Select propriedade não pode ser atribuída a um valor.

• A GroupBy propriedade não pode ser atribuída a um valor.

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

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

Você pode restringir quais propriedades são exibidas em um controle associado a dados de duas maneiras. Você pode definir a Select propriedade como um subconjunto de propriedades ou definir os campos para um controle associado a dados adicionando DataControlField controles. No entanto, se você definir a Select propriedade, isso significa que as operações automáticas de atualização, inserção e exclusão não podem ser habilitadas. Se você quiser habilitar 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 gerencie quais são exibidas usando o controle associado a dados. Ao usar o DetailsView controle ou o GridView controle, você também deve definir as AutoGenerateRows propriedades ou AutoGenerateColumns como false. Isso impede que o controle associado a dados inclua automaticamente botões para editar e excluir os dados. Todos os valores que não são exibidos no controle associado a dados são armazenados no estado de exibição. Eles são passados inalterados para a fonte de dados quando a atualização de dados é executada.

Avaliando valores em tempo de execução

Se você precisar avaliar valores em tempo de execução para ordenação, filtragem ou agrupamento de valores, você poderá adicionar parâmetros às WhereParameterscoleções, OrderGroupsByParametersGroupByParametersàs coleções.OrderByParameters

Se você quiser especificar valores padrão, poderá adicionar parâmetros à InsertParameters coleção.

Se você quiser examinar ou modificar valores antes que a operação de dados seja executada, você poderá lidar com os Deletingeventos, SelectingInsertingouUpdating. Você também pode lidar com esses eventos para cancelar a operação de dados ou examinar erros de validação que ocorreram quando você define propriedades na classe de dados com base na entrada do usuário.

Para examinar os valores após a conclusão da operação de dados, manipule os Deletedeventos ou, Insertedem Updated seguida, Selectedos eventos.

Trabalhando com procedimentos armazenados

Use o LinqDataSource controle para recuperar dados de um procedimento armazenado criando um manipulador de eventos para o Selecting evento. No manipulador de eventos, você chama o método na classe de contexto de dados que representa o procedimento armazenado e define o resultado para a Result propriedade do LinqDataSourceSelectEventArgs objeto. Se você quiser habilitar operações automáticas de atualização, inserção e exclusão para os dados, o tipo retornado do método deverá corresponder ao tipo especificado na TableName propriedade. Para obter mais informações sobre como criar métodos de contexto de dados, consulte Como criar métodos DataContext mapeados para procedimentos e funções armazenados (Designer O/R).

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>

Confira também

• LINQ para SQL