Sdílet prostřednictvím


LinqDataSource Třída

Definice

Umožňuje použití Language-Integrated Query (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::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
Dědičnost
Atributy
Implementuje

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

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.

Poznámka

Při použití LinqDataSource ovládacího prvku s SQL Server 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í AutoPage je truevlastnost . Pokud vlastnosti přiřadíte hodnotu Select , musíte také zahrnout všechny sloupce identity do seznamu vlastností vrácených v dotazu.

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:

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

LinqDataSource()

Inicializuje novou instanci LinqDataSource třídy .

Vlastnosti

Adapter

Získá adaptér specifický pro prohlížeč pro ovládací prvek.

(Zděděno od Control)
AppRelativeTemplateSourceDirectory

Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek.

(Zděděno od Control)
AutoGenerateOrderByClause

Získá nebo nastaví hodnotu, která označuje, zda LinqDataSource ovládací prvek dynamicky vytvoří klauzuli Order By na základě hodnot v kolekci OrderByParameters .

AutoGenerateWhereClause

Získá nebo nastaví hodnotu, která označuje, zda LinqDataSource ovládací prvek dynamicky vytváří 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 mezi oddíly dat za běhu.

AutoSort

Získá nebo nastaví hodnotu, která označuje, zda LinqDataSource ovládací prvek podporuje řazení dat za běhu.

BindingContainer

Získá ovládací prvek, který obsahuje datové vazby 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í znak oddělovače 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 obsahuje data, která chcete načíst.

Controls

ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný serverový ovládací prvek v hierarchii uživatelského rozhraní.

(Zděděno od DataSourceControl)
DataItemContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer.

(Zděděno od Control)
DataKeysContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl.

(Zděděno od Control)
DeleteParameters

Tato vlastnost není používána LinqDataSource třídou .

DesignMode

Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše.

(Zděděno od Control)
EnableDelete

Získá nebo nastaví hodnotu, která označuje, zda datové záznamy mohou být odstraněny LinqDataSource prostřednictvím ovládacího prvku.

EnableInsert

Získá nebo nastaví hodnotu, která označ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 jsou sledovány změny objektu kontextu dat.

EnableTheming

Získá hodnotu označ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 záznamy dat 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, pro žá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 Insert, Delete a Update.

(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 jsou použity pro seskupení načtených dat.

GroupByParameters

Získá kolekci parametrů, které se používají k vytvoření klauzule Seskupit podle.

HasChildViewState

Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení.

(Zděděno od Control)
ID

Získá nebo nastaví programový identifikátor přiřazený k 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é jsou použity během operace vložení.

IsChildControlStateCleared

Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení.

(Zděděno od Control)
IsTrackingViewState

Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do 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 označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu.

(Zděděno od Control)
NamingContainer

Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl 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í pro řazení načtených dat.

OrderByParameters

Získá kolekci parametrů, které jsou použity k vytvoření Order By klauzule.

OrderGroupsBy

Získá nebo nastaví pole, která se používají pro řazení seskupených dat.

OrderGroupsByParameters

Získá kolekci parametrů, které jsou použity k vytvoření Order Groups By klauzule.

Page

Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek.

(Zděděno od Control)
Parent

Získá odkaz na serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky.

(Zděděno od Control)
RenderingCompatibility

Získá hodnotu, která určuje ASP.NET verze, která vykreslí 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é jsou použity během operace načítání dat.

Site

Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše.

(Zděděno od Control)
SkinID

Získá kůži, která má být aplikována na DataSourceControl ovládací prvek.

(Zděděno od DataSourceControl)
StoreOriginalValuesInViewState

Získá nebo nastaví hodnotu, která označuje, zda data ze zdroje dat by měla být 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 ve třídě kontextu dat, 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í serverový ovládací prvek.

(Zděděno od Control)
UniqueID

Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku.

(Zděděno od Control)
UpdateParameters

Tato kolekce není používána LinqDataSource třídou .

ValidateRequestMode

Získá nebo nastaví hodnotu, která označ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í serverového ovládacího prvku napříč více požadavky na stejnou stránku.

(Zděděno od Control)
ViewStateIgnoresCase

Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena.

(Zděděno od Control)
ViewStateMode

Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku.

(Zděděno od Control)
Visible

Získá nebo nastaví hodnotu označ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, aby záznam byl zahrnut do načtených dat.

WhereParameters

Získá kolekci parametrů, která se používá k vytvoření klauzule Where.

Metody

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í ovládací prvek serveru, že byl analyzován prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru.

(Zděděno od Control)
ApplyStyleSheetSkin(Page)

Použije vlastnosti stylu, které jsou definovány v šabloně stylů stránky na ovládací prvek.

(Zděděno od DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Zahájí trasování vykreslování dat v době návrhu.

(Zděděno od Control)
BuildProfileTree(String, Boolean)

Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování.

(Zděděno od Control)
ClearCachedClientID()

Nastaví hodnotu v ClientID mezipaměti na null.

(Zděděno od Control)
ClearChildControlState()

Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearChildState()

Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearChildViewState()

Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků 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()

Volá se rozhraním ASP.NET stránky, aby upozornily ovládací prvky serveru, které používají implementaci založenou na složení k vytvoření všech 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 uložení 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 vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky.

(Zděděno od Control)
DataBind(Boolean)

Vytvoří vazbu zdroje dat na vyvoláný 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()

Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku.

(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í vykreslovaných dat v době návrhu.

(Zděděno od Control)
EnsureChildControls()

Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky.

(Zděděno od Control)
EnsureID()

Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor.

(Zděděno od Control)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
FindControl(String)

Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným id parametrem.

(Zděděno od DataSourceControl)
FindControl(String, Int32)

Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným id a celočíselným číslem zadaným v parametru pathOffset , který pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat.

(Zděděno od Control)
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í hashovací funkce.

(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ázev trasy.

(Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)

Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy.

(Zděděno od Control)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
GetUniqueIDRelativeTo(Control)

Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku.

(Zděděno od Control)
GetView(String)

Vrátí zobrazení zdroje dat, které je přidruženo k objektu LinqDataSource .

GetView(String)

Získá zobrazení zdroje dat, která je přidružena k objektu QueryableDataSource .

(Zděděno od QueryableDataSource)
GetViewNames()

Vrátí kolekci názvů, která představuje seznam objektů zobrazení, které jsou přidruženy k ovládacímu prvku LinqDataSource .

GetViewNames()

Získá kolekci názvů, které představují zobrazení, které jsou přidruženy k ovládacímu prvku QueryableDataSource .

(Zděděno od QueryableDataSource)
HasControls()

Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky.

(Zděděno od DataSourceControl)
HasEvents()

Vrátí hodnotu označ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, jestli serverový ovládací prvek obsahuje pouze obsah literálu.

(Zděděno od Control)
LoadControlState(Object)

Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() .

(Zděděno od Control)
LoadViewState(Object)

Načte stav hodnot v ovládacím LinqDataSource prvku, které musí být zachovány.

LoadViewState(Object)

Načte stav hodnot v ovládacím QueryableDataSource prvku, které musí být zachovány.

(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 Objectsouboru .

(Zděděno od Object)
OnBubbleEvent(Object, EventArgs)

Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru 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á zvyk 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ímu prvku.

(Zděděno od Control)
RaiseDataSourceChangedEvent(EventArgs)

DataSourceChanged Vyvolá událost.

(Zděděno od DataSourceControl)
RaiseViewChanged()

OnDataSourceViewChanged(EventArgs) Zavolá 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)

Odesílá obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu, který zapisuje obsah, který se má vykreslit na klientovi.

(Zděděno od Control)
RenderChildren(HtmlTextWriter)

Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi.

(Zděděno od Control)
RenderControl(HtmlTextWriter)

Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno.

(Zděděno od DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu.

(Zděděno od Control)
ResolveAdapter()

Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku.

(Zděděno od Control)
ResolveClientUrl(String)

Získá adresu URL, kterou lze použít v prohlížeči.

(Zděděno od Control)
ResolveUrl(String)

Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi.

(Zděděno od Control)
SaveControlState()

Uloží všechny změny stavu ovládacího prvku serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server.

(Zděděno od Control)
SaveViewState()

Uloží aktuální stav LinqDataSource zobrazení ovládacího prvku.

SaveViewState()

Uloží aktuální stav QueryableDataSource zobrazení ovládacího prvku.

(Zděděno od QueryableDataSource)
SetDesignModeState(IDictionary)

Nastaví data v době návrhu ovládacího prvku.

(Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)

Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku.

(Zděděno od Control)
SetTraceData(Object, Object)

Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování.

(Zděděno od Control)
SetTraceData(Object, Object, Object)

Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, 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 LinqDataSource stavu zobrazení ovládacího prvku, aby je bylo možné uložit do objektu StateBag ovládacího prvku.

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

Aktualizace hodnoty parametrů, které se od předchozího požadavku změnily.

(Zděděno od QueryableDataSource)

Událost

ContextCreated

Vyvolá se po vytvoření instance objektu typu kontextu.

ContextCreating

Nastane před vytvořením instance objektu typu kontextu.

ContextDisposing

Vyvolá se před likvidací objektu typu kontextu.

DataBinding

Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat.

(Zděděno od Control)
Deleted

Nastane po dokončení operace odstranění.

Deleting

Nastane před operací odstranění.

Disposed

Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET.

(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

Vyvolá se po dokončení operace vložení.

Inserting

Nastane před operací vložení.

Load

Nastane při načtení serverového ovládacího prvku 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

Vyvolá se při přidání nebo odebrání dotazu z ovládacího prvku zdroje dat.

(Zděděno od QueryableDataSource)
Selected

Vyvolá se po dokončení operace načtení dat.

Selecting

Nastane před operací načtení dat.

Unload

Vyvolá se při uvolnění serverového ovládacího prvku z paměti.

(Zděděno od Control)
Updated

Vyvolá se po dokončení operace aktualizace.

Updating

Nastane před operací aktualizace.

Explicitní implementace rozhraní

IControlBuilderAccessor.ControlBuilder

Popis tohoto člena najdete v tématu ControlBuilder.

(Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()

Popis tohoto člena najdete v tématu GetDesignModeState().

(Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary).

(Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Popis tohoto člena najdete v tématu SetOwnerControl(Control).

(Zděděno od Control)
IControlDesignerAccessor.UserData

Popis tohoto člena najdete v tématu UserData.

(Zděděno od Control)
IDataBindingsAccessor.DataBindings

Popis tohoto člena najdete v tématu DataBindings.

(Zděděno od Control)
IDataBindingsAccessor.HasDataBindings

Popis tohoto člena najdete v tématu HasDataBindings.

(Zděděno od Control)
IDataSource.DataSourceChanged

Nastane při změně ovládacího prvku zdroje dat 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í pouze 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 najdete v tématu IDynamicDataSource.

IDynamicDataSource.EntitySetName

Popis tohoto člena najdete v tématu IDynamicDataSource.

IDynamicDataSource.Exception

Popis tohoto člena najdete v tématu IDynamicDataSource.

IExpressionsAccessor.Expressions

Popis tohoto člena najdete v tématu Expressions.

(Zděděno od Control)
IExpressionsAccessor.HasExpressions

Popis tohoto člena najdete 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 najdete v tématu AddParsedSubObject(Object).

(Zděděno od Control)

Metody rozšíření

ExpandDynamicWhereParameters(IDynamicDataSource)

Rozbalí dynamické filtry na Where parametry, které zdroj dat může použít.

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 názvů 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ému ovládacímu prvku zdroje dat.

LoadWith<TEntity>(LinqDataSource)

DataLoadOptions Nastaví hodnotu zdroje dat LINQ-to-SQL tak, aby vynutil načtení všech entit cizího klíče.

LoadWithForeignKeys(LinqDataSource, Type)

DataLoadOptions Nastaví hodnotu zdroje dat LINQ-to-SQL tak, aby vynutil načtení všech entit cizího klíče.

TryGetMetaTable(IDataSource, MetaTable)

Určuje, jestli jsou k dispozici metadata tabulky.

Platí pro

Viz také