LinqDataSource Třída

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

Umožňuje použití Language-Integrated Dotazu (LINQ) na webové stránce ASP.NET prostřednictvím textu značek k načtení a úpravě dat z datového objektu.

public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, 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.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource

Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource

Dědičnost

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Atributy

ToolboxBitmapAttribute

Implementuje

IDynamicDataSource IDataSource

Příklady

Následující příklad ukazuje LinqDataSource ovládací prvek, který načte data z třídy entity s názvem Products. Třídu entity bylo možné vygenerovat pomocí Návrháře relací objektů nebo nástroje SqlMetal.exe. Vlastnost Where je nastavena 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 LinqDataSource ovládací prvek k zobrazení dat.

<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 LinqDataSource ovládací prvek, 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 LinqDataSource ovládací prvek, který je nakonfigurován pro seskupení podle dvou sloupců. Vlastnost Key odkazuje na objekt, který má dvě vlastnosti, ProductCategory a Color. Objekt reprezentovaný It je přejmenován (aliased) na Products. Přejmenovaný Products objekt obsahuje kolekci jednotlivých záznamů ve 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 zobrazí seskupené data a druhý ListView ovládací prvek zobrazí jednotlivé názvy produktů, které patří do této skupiny. Vlastnost vnořeného ovládacího prvku DataSource vázaného na data je nastavena 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:

• Introduction

• Pořadí operací

• Řazení dat

• Seskupování dat

• Úpravy dat

• Vyhodnocení hodnot za běhu

• Práce s uloženými procedurami

• Deklarativní syntaxe

Introduction

Language-Integrated Dotaz (LINQ) je syntaxe dotazu, která definuje sadu operátorů dotazu, které umožňují operace procházení, filtrování a projekce vyjádřit deklarativním způsobem . 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 bez nutnosti psát příkazy SQL pro každou operaci.

Ovládací LinqDataSource prvek umožňuje použít 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 naleznete v tématu LINQ to SQL.

Při načítání dat 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ě vlastnost nastavíte ContextTypeNamePerson a nastavíte vlastnost 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 Object Relational Designer nebo nástroj SqlMetal.exe. Pak nastavíte ContextTypeName vlastnost na třídu, která představuje databázi a nastavit TableName vlastnost na vlastnost, která představuje tabulku databáze.

Pořadí operací

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

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

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

3. Seskupování podle (agregované datové záznamy, které sdílejí hodnoty).

4. Pořadí skupin podle (seřazená seskupovaná data)

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

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

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

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

Řazení dat

Pomocí OrderBy vlastnosti můžete určit názvy vlastností z vrácených dat, podle které chcete řadit.

Poznámka:

Při použití LinqDataSource ovládacího prvku s SQL Serverem 2000 nebo SQL Server Compact 3.5 a AutoPage vlastnost je nastavena na true, musíte zadat hodnotu ve OrderBy vlastnosti. Ve výchozím nastavení je vlastnost AutoPagetrue. Pokud vlastnost přiřadíte hodnotu Select , musíte do seznamu vlastností vrácených v dotazu zahrnout také všechny sloupce identity.

Seskupování dat

Pomocí GroupBy vlastnosti můžete určit, které vlastnosti se používají ke konsolidaci datových záznamů se stejnými hodnotami. Když data seskupíte, můžete do vlastnosti zahrnout Key a It, které jsou dynamicky vytvořeny vlastnosti Select . Tato Key vlastnost odkazuje na hodnoty ve vlastnosti nebo vlastnostech, které byly použity k seskupení dat. Pokud například seskupíte podle vlastnosti s názvem Category, Key bude tato 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 nad It vlastností 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 tato 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 k řazení seskupených dat. Při seskupování dat OrderBy určuje vlastnost způsob řazení jednotlivých záznamů v rámci seskupených dat.

Ve výchozím nastavení ovládací LinqDataSource prvek načte hodnoty všech vlastností z datového objektu. Pomocí Select vlastnosti můžete určit, které vlastnosti se mají vrátit, pokud chcete pracovat s podmnožinou dostupných vlastností. Operace Vybrat se použije po operacích Where, Order By a Group By. Proto pokud v klauzuli Select vytvoříte název aliasu, alias není v ostatních klauzulích dostupný.

Úpravy dat

Pomocí parametru EnableDelete, EnableInserta EnableUpdate vlastností můžete určit, zda jsou povoleny ú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 na data, například DetailsView ovládacího prvku. Kromě nastavení EnableDelete, EnableInsertnebo EnableUpdate do true, jsou vyžadovány následující podmínky pro povolení automatických úprav dat:

• Vlastnost Select nelze přiřadit hodnotu.

• Vlastnost GroupBy nelze přiřadit hodnotu.

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

• Vlastnost, která je přiřazena TableName k vlastnosti musí být odvozena z Table<TEntity>.

Můžete omezit, které vlastnosti se zobrazí v ovládacím prvku vázaném na data dvěma způsoby. Vlastnost můžete buď nastavit Select na podmnožinu vlastností, nebo můžete definovat pole pro ovládací prvek svázaný s daty přidáním DataControlField ovládacích prvků. Pokud však vlastnost nastavíte Select , znamená to, že operace automatické 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. Pokud používáte DetailsView ovládací prvek nebo GridView ovládací prvek, musíte také nastavit AutoGenerateRows vlastnosti AutoGenerateColumns na false. Tím zabráníte automatickému zahrnutí tlačítek pro úpravy a odstranění dat v ovládacím prvku vázaném na data. Všechny hodnoty, které nejsou zobrazeny v ovládacím prvku vázaném na data, jsou uloženy ve stavu zobrazení. Při provedení aktualizace dat se do zdroje dat předají beze změny.

Vyhodnocení hodnot za běhu

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

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 operace dat, můžete zpracovat Deleting, Inserting, Selectingnebo Updating události. 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.

Chcete-li prozkoumat hodnoty po dokončení operace dat, zpracování DeletedInserted, , Selectednebo Updated událostí.

Práce s uloženými procedurami

Ovládací prvek slouží LinqDataSource k načtení dat z uložené procedury vytvořením obslužné rutiny události pro Selecting událost. V obslužné rutině události voláte metodu ve třídě kontextu dat, která představuje uloženou proceduru a nastaví výsledek na Result vlastnost objektu LinqDataSourceSelectEventArgs . Pokud chcete pro data povolit automatické operace aktualizace, vložení a odstranění, musí typ vrácený metodou odpovídat typu zadanému TableName ve vlastnosti. Další informace o vytváření metod kontextu dat naleznete v tématu Postupy: Vytvoření metod DataContext mapovaných na uložené procedury a funkce (Návrhář relací objektů).

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

Name	Description
LinqDataSource()	Inicializuje novou instanci LinqDataSource třídy.

Vlastnosti

Name	Description
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AppRelativeTemplateSourceDirectory	Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control)
AutoGenerateOrderByClause	Získá nebo nastaví hodnotu, která určuje, zda LinqDataSource ovládací prvek dynamicky vytváří Order By klauzule na základě hodnot v kolekci OrderByParameters .
AutoGenerateWhereClause	Získá nebo nastaví hodnotu, která určuje, zda LinqDataSource ovládací prvek dynamicky vytvoří klauzuli Where na základě hodnot definovaných v kolekci WhereParameters .
AutoPage	Získá nebo nastaví hodnotu, která označuje, zda LinqDataSource ovládací prvek podporuje navigaci v oddílech dat za běhu.
AutoSort	Získá nebo nastaví hodnotu, která určuje, zda LinqDataSource ovládací prvek podporuje řazení dat za běhu.
BindingContainer	Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control)
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClientID	Získá identifikátor ovládacího prvku serveru vygenerovaný ASP.NET. (Zděděno od DataSourceControl)
ClientIDMode	Tato vlastnost se nepoužívá pro ovládací prvky zdroje dat. (Zděděno od DataSourceControl)
ClientIDSeparator	Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control)
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
ContextTypeName	Získá nebo nastaví název typu, který obsahuje vlastnost, jejíž hodnota má data, která chcete načíst.
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od DataSourceControl)
DataItemContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control)
DeleteParameters	Tato vlastnost není používána LinqDataSource třídou.
DesignMode	Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control)
EnableDelete	Získá nebo nastaví hodnotu, která označuje, zda datové záznamy lze odstranit prostřednictvím LinqDataSource ovládacího prvku.
EnableInsert	Získá nebo nastaví hodnotu, která určuje, zda lze datové záznamy vložit prostřednictvím LinqDataSource ovládacího prvku.
EnableObjectTracking	Získá nebo nastaví hodnotu, která označuje, zda změny objektu kontextu dat jsou sledovány.
EnableTheming	Získá hodnotu určující, zda tento ovládací prvek podporuje motivy. (Zděděno od DataSourceControl)
EnableUpdate	Získá nebo nastaví hodnotu, která označuje, zda lze datové záznamy aktualizovat prostřednictvím LinqDataSource ovládacího prvku.
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control)
EntitySetName	Získá nebo nastaví název vlastnosti nebo pole v objektu zdroje dat, který představuje kolekci dat. (Zděděno od ContextDataSource)
EntityTypeName	Získá nebo nastaví název typu, který je vytvořen pro operace vložení, odstranění a aktualizace. (Zděděno od ContextDataSource)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
GroupBy	Získá nebo nastaví hodnotu, která určuje, které vlastnosti se používají pro seskupení načtených dat.
GroupByParameters	Získá kolekci parametrů, které se používají k vytvoření klauzule Group By.
HasChildViewState	Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control)
ID	Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
InsertParameters	Získá kolekci parametrů, které se používají během operace vložení.
IsChildControlStateCleared	Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LoadViewStateByID	Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
OrderBy	Získá nebo nastaví hodnotu, která určuje, která pole se používají k řazení načtených dat.
OrderByParameters	Získá kolekci parametrů, které se používají k vytvoření Order By klauzule.
OrderGroupsBy	Získá nebo nastaví pole, která se používají k seřazení seskupených dat.
OrderGroupsByParameters	Získá kolekci parametrů, které se používají k vytvoření klauzule Order Groups By.
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control)
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control)
Select	Získá nebo nastaví vlastnosti a počítané hodnoty, které jsou zahrnuty v načtených datech.
SelectParameters	Získá kolekci parametrů, které se používají během operace načítání dat.
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá kůži, která se použije na DataSourceControl ovládací prvek. (Zděděno od DataSourceControl)
StoreOriginalValuesInViewState	Získá nebo nastaví hodnotu, která označuje, zda mají být data ze zdroje dat uložena ve stavu zobrazení, aby se zajistilo, že data nebyla změněna jiným procesem před aktualizací nebo odstraněním.
TableName	Získá nebo nastaví název vlastnosti nebo pole v datové kontext třídy, která představuje kolekci dat.
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control)
UpdateParameters	Tato kolekce není používána LinqDataSource třídou.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu určující, zda je ovládací prvek vizuálně zobrazen. (Zděděno od DataSourceControl)
Where	Získá nebo nastaví hodnotu, která určuje, jaké podmínky musí být splněny pro záznam, který má být zahrnut do načtených dat.
WhereParameters	Získá kolekci parametrů, které se používají k vytvoření klauzule Where.

Metody

Name	Description
AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddParsedSubObject(Object)	Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu uloženou ClientID v mezipaměti na nullhodnotu . (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
CreateChildControls()	Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control)
CreateControlCollection()	Vytvoří kolekci pro ukládání podřízených ovládacích prvků. (Zděděno od DataSourceControl)
CreateQueryableView()	Vrátí dotazovatelné zobrazení.
CreateView()	Vytvoří novou instanci LinqDataSourceView třídy, která je přidružena k tomuto ovládacímu prvku.
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control)
Delete(IDictionary, IDictionary)	Provede operaci odstranění.
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindControl(String, Int32)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným id a celé číslo zadané v parametru pathOffset , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat. (Zděděno od Control)
FindControl(String)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným id parametrem. (Zděděno od DataSourceControl)
Focus()	Nastaví vstupní fokus na ovládací prvek. (Zděděno od DataSourceControl)
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control)
GetView(String)	Získá zobrazení zdroje dat, které je přidruženo k objektu QueryableDataSource . (Zděděno od QueryableDataSource)
GetViewNames()	Získá kolekci názvů, které představují zobrazení, která jsou přidružena k ovládacímu QueryableDataSource prvku. (Zděděno od QueryableDataSource)
HasControls()	Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od DataSourceControl)
HasEvents()	Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
Insert(IDictionary)	Provede operaci vložení.
IsLiteralContent()	Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control)
LoadViewState(Object)	Načte stav hodnot v ovládacím QueryableDataSource prvku, který musí být trvalý. (Zděděno od QueryableDataSource)
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Inicializuje LinqDataSource objekt.
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost. (Zděděno od Control)
OnUnload(EventArgs)	Unload Vyvolá událost.
OpenFile(String)	Stream Získá použité ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control)
RaiseDataSourceChangedEvent(EventArgs)	DataSourceChanged Vyvolá událost. (Zděděno od DataSourceControl)
RaiseViewChanged()	OnDataSourceViewChanged(EventArgs) Volá metodu DataSourceView třídy. (Zděděno od QueryableDataSource)
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	Odešle obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od DataSourceControl)
ResolveAdapter()	Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží aktuální stav QueryableDataSource zobrazení ovládacího prvku. (Zděděno od QueryableDataSource)
SetDesignModeState(IDictionary)	Nastaví data návrhu pro ovládací prvek. (Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Sleduje změny QueryableDataSource stavu zobrazení ovládacího prvku tak, aby změny mohly být uloženy v objektu StateBag ovládacího prvku. (Zděděno od QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)	Provede operaci aktualizace.
UpdateParameterVales()	Aktualizuje hodnoty parametrů, které se od předchozího požadavku změnily. (Zděděno od QueryableDataSource)

Událost

Name	Description
ContextCreated	Nastane po vytvoření instance objektu typu kontextu.
ContextCreating	Nastane před vytvořením instance objektu typu kontextu.
ContextDisposing	Nastane před zveřejněním objektu typu kontextu.
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control)
Deleted	Nastane po dokončení operace odstranění.
Deleting	Nastane před operací odstranění.
Disposed	Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Inserted	Nastane po dokončení operace vložení.
Inserting	Nastane před operací vložení.
Load	Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
QueryCreated	Nastane, když se dotaz přidá nebo odebere ze správy zdroje dat. (Zděděno od QueryableDataSource)
Selected	Nastane po dokončení operace načítání dat.
Selecting	Nastane před operací načítání dat.
Unload	Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control)
Updated	Nastane po dokončení operace aktualizace.
Updating	Nastane před operací aktualizace.

Explicitní implementace rozhraní

Name	Description
IControlBuilderAccessor.ControlBuilder	Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control)
IDataSource.DataSourceChanged	Nastane, když se ovládací prvek zdroje dat změnil způsobem, který ovlivňuje ovládací prvky vázané na data. (Zděděno od DataSourceControl)
IDataSource.GetView(String)	Získá pojmenovaný DataSourceView objekt přidružený k ovládacímu DataSourceControl prvku. Některé ovládací prvky zdroje dat podporují jenom jedno zobrazení, zatímco jiné podporují více než jedno. (Zděděno od DataSourceControl)
IDataSource.GetViewNames()	Získá kolekci názvů představující seznam objektů přidružených DataSourceView k ovládacímu DataSourceControl prvku. (Zděděno od DataSourceControl)
IDynamicDataSource.ContextType	Popis tohoto člena naleznete v tématu IDynamicDataSource.
IDynamicDataSource.EntitySetName	Popis tohoto člena naleznete v tématu IDynamicDataSource.
IDynamicDataSource.Exception	Popis tohoto člena naleznete v tématu IDynamicDataSource.
IExpressionsAccessor.Expressions	Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control)
IListSource.ContainsListCollection	Určuje, jestli je ovládací prvek zdroje dat přidružený k jednomu nebo více seznamům dat. (Zděděno od DataSourceControl)
IListSource.GetList()	Získá seznam ovládacích prvků zdroje dat, které lze použít jako zdroje seznamů dat. (Zděděno od DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control)

Metody rozšíření

Name	Description
ExpandDynamicWhereParameters(IDynamicDataSource)	Rozšíří dynamické filtry na Where parametry, které je možné použít ve zdroji dat.
FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.
GetDefaultValues(IDataSource)	Získá kolekci výchozích hodnot pro zadaný zdroj dat.
GetMetaTable(IDataSource)	Získá metadata pro tabulku v zadaném objektu zdroje dat.
GetTable(IDynamicDataSource)	MetaTable Vrátí objekt přidružený k zadané správě zdroje dat.
LoadWith<TEntity>(LinqDataSource)	DataLoadOptions Nastaví hodnotu zdroje dat LINQ-to-SQL tak, aby se načetly všechny entity cizího klíče.
LoadWithForeignKeys(LinqDataSource, Type)	DataLoadOptions Nastaví hodnotu zdroje dat LINQ-to-SQL tak, aby se načetly všechny entity cizího klíče.
TryGetMetaTable(IDataSource, MetaTable)	Určuje, zda jsou k dispozici metadata tabulky.

Viz také

• LINQ to SQL