LinqDataSource.GroupBy Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un valore che specifica le proprietà utilizzate per raggruppare i dati recuperati.

public:
 property System::String ^ GroupBy { System::String ^ get(); void set(System::String ^ value); };

public string GroupBy { get; set; }

member this.GroupBy : string with get, set

Public Property GroupBy As String

Valore della proprietà

String

Stringa utilizzata per creare la clausola Group By.

Esempio

Nell'esempio seguente viene illustrato un controllo LinqDataSource che raggruppa i dati restituiti da una proprietà denominata Category. Restituisce i valori condivisi e calcola il prezzo medio per i record raggruppati.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    GroupBy="Category"
    Select="new(Key as ProductCategory, 
            Average(Price) as AvePrice)"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    GroupBy="Category"
    Select="new(Key as ProductCategory, 
            Average(Price) as AvePrice)"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Nell'esempio seguente viene illustrato un controllo LinqDataSource configurato per raggruppare per due colonne. La proprietà Key fa riferimento a un oggetto con due proprietà, ProductCategory e Color. L'oggetto rappresentato da It viene rinominato Products. L'oggetto Products rinominato contiene un insieme di singoli record in un raggruppamento e ogni istanza contiene tutte le colonne della tabella Products.

<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 controlli ListView per visualizzare i dati del controllo LinqDataSource nell'esempio precedente. Un controllo ListView visualizza i dati raggruppati e l'altro controllo ListView visualizza i singoli nomi dei prodotti appartenenti a tale gruppo. La proprietà DataSource del 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

Utilizzare la proprietà GroupBy per specificare le proprietà utilizzate per consolidare i record di dati con gli stessi valori. Ad esempio, se si imposta la proprietà GroupBy su Name, tutti i record nella query con lo stesso valore della proprietà Name vengono restituiti come un singolo record consolidato.

È possibile assegnare più proprietà alla proprietà GroupBy racchiudendo tutte le proprietà nella funzione new e separando ogni proprietà usando una virgola. Ad esempio, per raggruppare in base alle proprietà Name e quindi Category, impostare la proprietà GroupBy su new(Name, Category).

I valori nella proprietà utilizzati per il raggruppamento vengono restituiti tramite una proprietà generata denominata Key. Includere la proprietà Key nella proprietà Select per recuperare i valori raggruppati. È possibile impostare la proprietà Key su un alias usando la parola chiave As, ma non è necessario usare un alias. Ad esempio, è possibile impostare la proprietà GroupBy su una proprietà denominata Category. È possibile recuperare i valori consolidati dalla proprietà Category impostando la proprietà Select su new(Key As ProductCategory).

È possibile accedere ai singoli record in un raggruppamento includendo la proprietà It nella proprietà Select. La proprietà It contiene una raccolta di record che condividono un valore nella proprietà raggruppata. È possibile scorrere la proprietà It per recuperare i singoli record.

La proprietà GroupBy viene spesso utilizzata con i metodi di aggregazione. È possibile usare i metodi di aggregazione seguenti:

Count()
colonna
colonna
colonna
colonna
Where( condizione)
Any()
All( condizione)

Per altre informazioni, vedere Cenni preliminari sul controllo server Web LinqDataSource e Procedura: Raggruppare e aggregare i dati usando il controllo LinqDataSource.

Si applica a

Condividi tramite