LinqDataSource Třída

Definice

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

Dědičnost

Object

Control

DataSourceControl

LinqDataSource

Dědičnost

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Atributy

ToolboxBitmapAttribute

Implementuje

IDynamicDataSource IDataSource

Příklady

Následující příklad ukazuje ovládací prvek LinqDataSource , který načítá data z třídy entity s názvem Products. Třída entity mohla být vygenerována pomocí Designer O/R nebo nástroje SqlMetal.exe. Vlastnost je nastavena Where tak, aby vracela pouze záznamy, které mají hodnotu ve Price vlastnosti větší než 50. Ovládací GridView prvek je vázán na ovládací prvek LinqDataSource , aby se zobrazila data.

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

Následující příklad ukazuje ovládací prvek LinqDataSource , který uživatelům umožňuje aktualizovat, odstranit a vložit záznamy do zdroje dat. Ovládací DetailsView prvek je vázán na LinqDataSource ovládací prvek a umožňuje uživatelům zobrazit a upravit data. Všimněte si, že k výběru, aktualizaci, odstranění nebo vložení záznamů nejsou potřeba žádné příkazy SQL.

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

Následující příklad ukazuje obslužnou rutinu Selecting události pro událost, která nastaví datový objekt na základě hodnoty na webové stránce.

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

Následující příklad ukazuje ovládací prvek LinqDataSource , který je nakonfigurován tak, aby seskupil podle dvou sloupců. Vlastnost Key odkazuje na objekt, který má dvě vlastnosti, ProductCategory a Color. Objekt reprezentovaný se It přejmenuje (aliasuje) na Products. Přejmenovaný Products objekt obsahuje kolekci jednotlivých záznamů v seskupení. Každá instance bude obsahovat všechny sloupce z Products tabulky.

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

Následující příklad ukazuje dva ListView ovládací prvky, které zobrazují data z LinqDataSource ovládacího prvku v předchozím příkladu. Jeden ListView ovládací prvek zobrazuje seskupovaná data a druhý ListView zobrazuje jednotlivé názvy produktů, které patří do této skupiny. Vlastnost vnořeného ovládacího prvku vázaného DataSource na data je nastavená na Products, což je alias objektu 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>

Poznámky

V tomto tématu:

• Úvod

• Pořadí operací

• Řazení dat

• Seskupování dat

• Úpravy dat

• Vyhodnocení hodnot za běhu

• Práce s uloženými procedurami

• Deklarativní syntaxe

Úvod

Language-Integrated Query (LINQ) je syntaxe dotazu, která definuje sadu operátorů dotazu, které umožňují vyjádřit operace procházení, filtrování a projekce deklarativním způsobem v libovolném objektu . Programovací jazyk založený na technologii NET. Datový objekt může být kolekce dat v paměti nebo objekt, který představuje data z databáze. Data můžete načíst nebo upravit, aniž byste museli psát příkazy SQL pro každou operaci.

Ovládací LinqDataSource prvek umožňuje používat LINQ na webové stránce ASP.NET nastavením vlastností v textu značek. Ovládací LinqDataSource prvek používá LINQ to SQL k automatickému vygenerování datových příkazů. Další informace o LINQ to SQL najdete v tématu LINQ to SQL.

Když načítáte data z kolekce dat v paměti, nastavíte ContextTypeName vlastnost na třídu, která obsahuje kolekci dat. Vlastnost nastavíte TableName na vlastnost nebo pole, které vrací kolekci dat. Můžete mít například třídu s názvem Person , která obsahuje vlastnost s názvem FavoriteCities , která vrací pole řetězcových hodnot. V takovém případě nastavíte ContextTypeName vlastnost na Person a vlastnost nastavíte TableName na FavoriteCities.

Při dotazování databáze musíte nejprve vytvořit třídy entit, které představují databázi a její tabulky. K vygenerování těchto tříd můžete použít Návrhář relací objektů nebo nástroj SqlMetal.exe. Potom nastavíte ContextTypeName vlastnost na třídu, která představuje databázi, a vlastnost na vlastnost TableName , která představuje tabulku databáze.

Pořadí operací

Ovládací LinqDataSource prvek používá operace s daty v následujícím pořadí:

1. Where (zadejte, které datové záznamy se mají vrátit).

2. Seřadit podle (seřadit).

3. Seskupovat podle (agregovat datové záznamy, které sdílejí hodnoty).

4. Řazení skupin podle (řazení seskupených dat)

5. Vyberte (určete, která pole nebo vlastnosti chcete vrátit).

6. Automatické řazení (řazení datových záznamů podle vlastnosti, kterou uživatel vybral)

7. Automatická stránka (načte podmnožinu datových záznamů vybraných uživatelem).

Do vlastnosti můžete přidat podmínky Where pro filtrování datových záznamů vrácených dotazem. Where Pokud vlastnost není nastavena, LinqDataSource ovládací prvek načte všechny záznamy z datového objektu.

Řazení dat

Vlastnost slouží OrderBy k určení názvů vlastností z vrácených dat, podle které chcete řadit.

Seskupování dat

Pomocí GroupBy vlastnosti určíte, které vlastnosti se použijí ke sloučení datových záznamů, které mají stejné hodnoty. Při seskupení dat můžete do Select vlastnosti zahrnout Key a It, což jsou dynamicky vytvořené vlastnosti. Vlastnost Key odkazuje na hodnoty ve vlastnosti nebo vlastnosti, které byly použity k seskupení dat. Pokud například seskupíte podle vlastnosti s názvem Category, Key bude vlastnost obsahovat všechny jedinečné hodnoty ve Category vlastnosti. Vlastnost It odkazuje na kolekci jednotlivých záznamů v seskupení dat. Můžete iterovat vlastnost It a načíst jednotlivé záznamy, které byly sloučeny v operaci seskupení. Pokud například seskupíte podle vlastnosti s názvem Category, It vlastnost obsahuje všechny jednotlivé záznamy, které sdílejí společnou hodnotu ve Category vlastnosti.

Vlastnost slouží OrderGroupsBy k určení vlastností, které se mají použít pro řazení seskupených dat. Když seskupíte data, vlastnost určuje, OrderBy jak jsou seřazeny jednotlivé záznamy v rámci seskupených dat.

Ve výchozím nastavení LinqDataSource ovládací prvek načítá hodnoty pro všechny vlastnosti z datového objektu. Vlastnost slouží Select k určení, které vlastnosti se mají vrátit, pokud chcete pracovat s podmnožinou dostupných vlastností. Operace Select se použije po operacích Where, Order By a Seskupovat podle. Proto pokud vytvoříte název s aliasy v klauzuli Select, alias není k dispozici v ostatních klauzulích.

Úpravy dat

Pomocí vlastností , a EnableUpdate můžete určit, EnableInsertjestli jsou povolené EnableDeleteúpravy dat. Uživatelské rozhraní pro úpravu LinqDataSource dat z ovládacího prvku se obvykle poskytuje prostřednictvím ovládacího prvku vázaného DetailsView na data, například ovládacího prvku. Kromě nastavení EnableDelete, EnableInsert, nebo EnableUpdate pro truejsou k povolení automatických úprav dat vyžadovány následující podmínky:

• Vlastnost Select nelze přiřadit hodnotu.

• Vlastnost GroupBy nelze přiřadit hodnotu.

• Třída, která je přiřazena ContextTypeName vlastnosti, musí být odvozena z DataContext.

• Vlastnost přiřazená vlastnosti TableName musí být odvozena od Table<TEntity>vlastnosti .

Vlastnosti, které jsou zobrazeny v ovládacím prvku vázaném na data, můžete omezit dvěma způsoby. Můžete buď nastavit Select vlastnost na podmnožinu vlastností, nebo můžete definovat pole pro ovládací prvek vázané na data přidáním DataControlField ovládacích prvků. Pokud ale vlastnost nastavíte Select , znamená to, že automatické operace aktualizace, vložení a odstranění nelze povolit. Pokud chcete povolit automatické úpravy dat při práci s podmnožinou dostupných vlastností, nenastavujte Select vlastnost. Místo toho načtěte všechny vlastnosti z datového objektu a spravujte, které vlastnosti se zobrazí pomocí ovládacího prvku vázaného na data. Při použití DetailsView ovládacího prvku nebo GridView ovládacího prvku musíte také nastavit AutoGenerateRows vlastnosti nebo AutoGenerateColumns na falsehodnotu . Tím se ovládacímu prvku vázanému na data zabrání automatickému zahrnutí tlačítek pro úpravy a odstranění dat. Všechny hodnoty, které nejsou zobrazeny v ovládacím prvku vázaném na data, jsou uloženy ve stavu zobrazení. Při aktualizaci dat se předávají zdroji dat beze změny.

Vyhodnocení hodnot za běhu

Pokud potřebujete vyhodnotit hodnoty za běhu pro řazení, filtrování nebo seskupení hodnot, můžete přidat parametry do WhereParameterskolekcí , GroupByParameters, OrderGroupsByParametersnebo OrderByParameters .

Pokud chcete zadat výchozí hodnoty, můžete do InsertParameters kolekce přidat parametry.

Pokud chcete prozkoumat nebo upravit hodnoty před spuštěním datové operace, můžete zpracovat Deletingudálosti , Inserting, Selectingnebo Updating . Tyto události můžete také zpracovat, abyste zrušili operaci dat nebo prozkoumali chyby ověření, ke kterým došlo při nastavování vlastností v datové třídě na základě vstupu uživatele.

Pokud chcete prozkoumat hodnoty po dokončení operace s daty, zpracujte Deletedudálosti , Inserted, Selectednebo Updated .

Práce s uloženými procedurami

Pomocí LinqDataSource ovládacího prvku můžete načíst data z uložené procedury vytvořením obslužné rutiny události pro Selecting událost. V obslužné rutině události zavoláte metodu ve třídě kontextu dat, která představuje uloženou proceduru, a nastavíte výsledek na Result vlastnost objektu LinqDataSourceSelectEventArgs . Pokud chcete povolit automatické operace aktualizace, vložení a odstranění dat, musí typ vrácený metodou odpovídat typu zadanému TableName ve vlastnosti. Další informace o vytváření metod kontextu dat najdete v tématu Postupy: Vytváření metod DataContext mapovaných na uložené procedury a funkce (Designer O/R).

Deklarativní syntaxe

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

Konstruktory

Vlastnosti

Metody

Událost

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• Technologie LINQ to SQL