LinqDataSource Classe

Definizione

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

Ereditarietà

Object

Control

DataSourceControl

LinqDataSource

Ereditarietà

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Attributi

ToolboxBitmapAttribute

Implementazioni

IDynamicDataSource IDataSource

Esempio

Nell'esempio seguente viene illustrato un LinqDataSource controllo che recupera i dati da una classe di entità denominata Products. La classe di entità potrebbe essere stata generata usando O/R Designer o l'utilità di SqlMetal.exe. La Where proprietà è impostata per restituire solo i record con un valore nella Price proprietà maggiore di 50. Un GridView controllo è associato al LinqDataSource controllo per visualizzare i dati.

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

Nell'esempio seguente viene illustrato un LinqDataSource controllo che consente agli utenti di aggiornare, eliminare e inserire record nell'origine dati. Un DetailsView controllo è associato al LinqDataSource controllo e consente agli utenti di visualizzare e modificare i dati. Si noti che non sono necessari comandi SQL per selezionare, aggiornare, eliminare o inserire i record.

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

Nell'esempio seguente viene illustrato un gestore eventi per l'evento che imposta l'oggetto Selecting dati in base a un valore nella pagina 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

Nell'esempio seguente viene illustrato un LinqDataSource controllo configurato per il raggruppamento in base a due colonne. La Key proprietà fa riferimento a un oggetto con due proprietà e ProductCategoryColor. L'oggetto rappresentato da It viene rinominato (aliasato) in Products. L'oggetto rinominato Products contiene una raccolta di singoli record in un raggruppamento. Ogni istanza conterrà tutte le colonne della Products tabella.

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

Nell'esempio seguente vengono illustrati due ListView controlli che visualizzano i dati del LinqDataSource controllo nell'esempio precedente. Un ListView controllo visualizza i dati raggruppati e l'altro ListView controllo visualizza i singoli nomi dei prodotti che appartengono a tale gruppo. La proprietà del DataSource controllo con associazione a dati annidata è impostata su Products, ovvero l'alias per l'oggetto It .

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

Commenti

In questo argomento:

• Introduzione

• Ordine delle operazioni

• Ordinamento dei dati

• Raggruppamento di dati

• Modifiche ai dati

• Valutazione dei valori in fase di esecuzione

• Utilizzo di stored procedure

• Sintassi dichiarativa

Introduzione

Language-Integrated Query (LINQ) è una sintassi di query che definisce un set di operatori di query che consentono l'espressione di operazioni di attraversamento, filtro e proiezione in modo dichiarativo in qualsiasi oggetto . Linguaggio di programmazione basato su NET. L'oggetto dati può essere una raccolta di dati in memoria o un oggetto che rappresenta i dati di un database. È possibile recuperare o modificare i dati senza dover scrivere comandi SQL per ogni operazione.

Il LinqDataSource controllo consente di usare LINQ in una pagina Web ASP.NET impostando le proprietà nel testo di markup. Il LinqDataSource controllo usa LINQ to SQL per generare automaticamente i comandi dati. Per altre informazioni su LINQ to SQL, vedere LINQ to SQL.

Quando si recuperano dati da una raccolta di dati in memoria, impostare la ContextTypeName proprietà sulla classe che contiene la raccolta dati. Impostare la TableName proprietà sulla proprietà o sul campo che restituisce la raccolta dati. Ad esempio, potrebbe essere presente una classe denominata Person che contiene una proprietà denominata FavoriteCities che restituisce una matrice di valori stringa. In tal caso, impostare la ContextTypeName proprietà su Person e impostare la TableName proprietà su FavoriteCities.

Quando si esegue una query su un database, è prima necessario creare classi di entità che rappresentano il database e le relative tabelle. È possibile usare Progettazione relazionale oggetti o l'utilità SqlMetal.exe per generare queste classi. Impostare quindi la ContextTypeName proprietà sulla classe che rappresenta il database e impostare la TableName proprietà sulla proprietà che rappresenta la tabella di database.

Ordine delle operazioni

Il LinqDataSource controllo applica le operazioni sui dati nell'ordine seguente:

1. Dove (specificare i record di dati da restituire).

2. Ordina per (ordinamento).

3. Raggruppa per (aggregare i record di dati che condividono valori).

4. Ordinare i gruppi per (ordinare i dati raggruppati).

5. Selezionare (specificare i campi o le proprietà da restituire).

6. Ordinamento automatico (ordinare i record di dati in base a una proprietà selezionata dall'utente).

7. Pagina automatica (recuperare un subset di record di dati selezionati dall'utente).

È possibile aggiungere condizioni alla Where proprietà per filtrare i record di dati restituiti da una query. Se la Where proprietà non è impostata, il LinqDataSource controllo recupera ogni record dall'oggetto dati.

Ordinamento dei dati

Utilizzare la OrderBy proprietà per specificare i nomi delle proprietà dai dati restituiti per l'ordinamento.

Raggruppamento dei dati

Utilizzare la GroupBy proprietà per specificare le proprietà utilizzate per consolidare i record di dati con gli stessi valori. Quando si raggruppano i dati, è possibile includere Key e It, che sono proprietà create dinamicamente, nella Select proprietà . La Key proprietà fa riferimento ai valori nella proprietà o nelle proprietà utilizzate per raggruppare i dati. Ad esempio, se si raggruppa in base a una proprietà denominata Category, la Key proprietà conterrà tutti i valori univoci nella Category proprietà . La It proprietà fa riferimento a una raccolta di singoli record in un raggruppamento di dati. È possibile eseguire l'iterazione sulla It proprietà per recuperare i singoli record consolidati nell'operazione di raggruppamento. Ad esempio, se si raggruppa in base a una proprietà denominata Category, la It proprietà contiene tutti i singoli record che condividono un valore comune nella Category proprietà .

Utilizzare la OrderGroupsBy proprietà per specificare le proprietà da utilizzare per l'ordinamento dei dati raggruppati. Quando si raggruppano i dati, la OrderBy proprietà specifica la modalità di ordinamento dei singoli record all'interno dei dati raggruppati.

Per impostazione predefinita, il LinqDataSource controllo recupera i valori per tutte le proprietà da un oggetto dati. Utilizzare la Select proprietà per specificare le proprietà da restituire se si desidera utilizzare un subset di proprietà disponibili. L'operazione Select viene applicata dopo le operazioni Where, Order By e Group By. Pertanto, se si crea un nome con alias in una clausola Select, l'alias non è disponibile nelle altre clausole.

Modifiche ai dati

È possibile specificare se le modifiche ai dati sono abilitate usando le EnableDeleteproprietà , EnableInserte EnableUpdate . L'interfaccia utente per la modifica dei dati da un LinqDataSource controllo viene in genere fornita tramite un controllo associato a dati, ad esempio un DetailsView controllo . Oltre a impostare EnableDelete, EnableInserto EnableUpdate su true, sono necessarie le condizioni seguenti per abilitare le modifiche automatiche ai dati:

• Non Select è possibile assegnare alla proprietà un valore.

• Non GroupBy è possibile assegnare alla proprietà un valore.

• La classe assegnata alla ContextTypeName proprietà deve derivare da DataContext.

• La proprietà assegnata alla TableName proprietà deve derivare da Table<TEntity>.

È possibile limitare le proprietà visualizzate in un controllo associato a dati in due modi. È possibile impostare la Select proprietà su un subset di proprietà oppure definire i campi per un controllo associato a dati aggiungendo DataControlField controlli. Tuttavia, se si imposta la Select proprietà , significa che le operazioni di aggiornamento automatico, inserimento ed eliminazione non possono essere abilitate. Se si desidera abilitare le modifiche automatiche dei dati mentre si lavora con un subset di proprietà disponibili, non impostare la Select proprietà . Recuperare invece tutte le proprietà dall'oggetto dati e gestire quelle visualizzate usando il controllo associato a dati. Quando si utilizza il DetailsView controllo o il GridView controllo , è necessario impostare anche le AutoGenerateRows proprietà o AutoGenerateColumns su false. Ciò impedisce al controllo associato a dati di includere automaticamente pulsanti per la modifica e l'eliminazione dei dati. Tutti i valori non visualizzati nel controllo associato a dati vengono archiviati nello stato di visualizzazione. Vengono passati invariati all'origine dati quando viene eseguito l'aggiornamento dei dati.

Valutazione dei valori in fase di esecuzione

Se è necessario valutare i valori in fase di esecuzione per ordinare, filtrare o raggruppare i valori, è possibile aggiungere parametri alle WhereParametersraccolte , GroupByParameters, OrderGroupsByParameterso OrderByParameters .

Se si desidera specificare i valori predefiniti, è possibile aggiungere parametri alla InsertParameters raccolta.

Se si desidera esaminare o modificare i valori prima dell'esecuzione dell'operazione di dati, è possibile gestire gli Deletingeventi , InsertingSelecting, o Updating . È anche possibile gestire questi eventi per annullare l'operazione sui dati o per esaminare gli errori di convalida che si sono verificati quando si impostano le proprietà nella classe di dati in base all'input dell'utente.

Per esaminare i valori al termine dell'operazione dati, gestire gli Deletedeventi , SelectedInserted, o Updated .

Utilizzo di stored procedure

Il controllo consente di LinqDataSource recuperare i dati da una stored procedure creando un gestore eventi per l'evento Selecting . Nel gestore eventi chiamare il metodo nella classe contesto dati che rappresenta la stored procedure e impostare il risultato sulla Result proprietà dell'oggetto LinqDataSourceSelectEventArgs . Se si desidera abilitare operazioni di aggiornamento automatico, inserimento ed eliminazione per i dati, il tipo restituito dal metodo deve corrispondere al tipo specificato nella TableName proprietà . Per altre informazioni sulla creazione di metodi del contesto dati, vedere Procedura: Creare metodi DataContext mappati a stored procedure e funzioni (O/R Designer).

Sintassi dichiarativa

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

Vedi anche

• LINQ to SQL