Udostępnij za pośrednictwem


LinqDataSource Klasa

Definicja

Umożliwia używanie Language-Integrated Query (LINQ) na stronie internetowej ASP.NET za pomocą tekstu znaczników w celu pobrania i zmodyfikowania danych z obiektu danych.

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
Dziedziczenie
Dziedziczenie
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie przedstawiono kontrolkę LinqDataSource , która pobiera dane z klasy jednostki o nazwie Products. Klasa jednostki mogła zostać wygenerowana przy użyciu Projektant O/R lub narzędzia SqlMetal.exe. Właściwość jest ustawiona Where tak, aby zwracała tylko rekordy, które mają wartość we właściwości większej Price niż 50. Kontrolka GridView jest powiązana z kontrolką, LinqDataSource aby wyświetlić dane.

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

W poniższym przykładzie przedstawiono kontrolkę umożliwiającą LinqDataSource użytkownikom aktualizowanie, usuwanie i wstawianie rekordów w źródle danych. Kontrolka DetailsView jest powiązana z kontrolką LinqDataSource i umożliwia użytkownikom wyświetlanie i modyfikowanie danych. Zwróć uwagę, że żadne polecenia SQL nie są wymagane, aby wybrać, zaktualizować, usunąć lub wstawić rekordy.

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

Poniższy przykład przedstawia procedurę obsługi zdarzeń dla Selecting zdarzenia, które ustawia obiekt danych na podstawie wartości na stronie sieci Web.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}
Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

W poniższym przykładzie przedstawiono kontrolkę skonfigurowaną LinqDataSource do grupowania według dwóch kolumn. Właściwość Key odwołuje się do obiektu, który ma dwie właściwości ProductCategory i Color. Nazwa obiektu reprezentowanego przez It obiekt jest zmieniana (aliasowana) na Products. Zmieniono Products nazwę obiektu zawiera kolekcję poszczególnych rekordów w grupowaniu. Każde wystąpienie będzie zawierać wszystkie kolumny z Products tabeli.

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

W poniższym przykładzie przedstawiono dwie ListView kontrolki, które wyświetlają dane z kontrolki LinqDataSource w poprzednim przykładzie. Jedna ListView kontrolka wyświetla pogrupowane dane, a druga ListView wyświetla poszczególne nazwy produktów należących do tej grupy. Właściwość zagnieżdżonej kontrolki DataSource powiązanej z danymi jest ustawiona na Productswartość , która jest aliasem It obiektu.

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

Uwagi

W tym temacie:

Wprowadzenie

Language-Integrated Query (LINQ) to składnia zapytania definiująca zestaw operatorów zapytań, które umożliwiają wykonywanie operacji przechodzenia, filtrowania i projekcji w sposób deklaratywny w dowolny sposób. Język programowania oparty na platformie NET. Obiekt danych może być kolekcją danych w pamięci lub obiektem reprezentującym dane z bazy danych. Możesz pobrać lub zmodyfikować dane bez konieczności pisania poleceń SQL dla każdej operacji.

Kontrolka LinqDataSource umożliwia używanie LINQ na stronie internetowej ASP.NET przez ustawienie właściwości w tekście znaczników. Kontrolka LinqDataSource używa LINQ to SQL do automatycznego generowania poleceń danych. Aby uzyskać więcej informacji na temat LINQ to SQL, zobacz LINQ to SQL.

Podczas pobierania danych z kolekcji danych w pamięci należy ustawić ContextTypeName właściwość na klasę zawierającą zbieranie danych. Właściwość jest ustawiana TableName na właściwość lub pole zwracające zbieranie danych. Na przykład może istnieć klasa o nazwie, która zawiera właściwość o nazwie PersonFavoriteCities , która zwraca tablicę wartości ciągów. W takim przypadku należy ustawić ContextTypeName właściwość na i ustawić PersonTableName właściwość na FavoriteCities.

Podczas wykonywania zapytań względem bazy danych należy najpierw utworzyć klasy jednostek reprezentujące bazę danych i jej tabele. Do wygenerowania tych klas można użyć narzędzia Object Relational Designer lub narzędzia SqlMetal.exe. Następnie ustaw ContextTypeName właściwość na klasę reprezentującą bazę danych i ustaw TableName właściwość na właściwość reprezentującą tabelę bazy danych.

Kolejność działań

Kontrolka LinqDataSource stosuje operacje danych w następującej kolejności:

  1. Gdzie (określ, które rekordy danych mają być zwracane).

  2. Order By (sort).

  3. Grupuj według (agregowanie rekordów danych, które współużytkują wartości).

  4. Porządkowaj grupy według (sortuj pogrupowane dane).

  5. Wybierz (określ pola lub właściwości do zwrócenia).

  6. Automatyczne sortowanie (sortowanie rekordów danych według właściwości wybranej przez użytkownika).

  7. Strona automatyczna (pobierz podzbiór rekordów danych wybranych przez użytkownika).

Możesz dodać warunki do Where właściwości, aby filtrować rekordy danych zwracane z zapytania. Jeśli właściwość nie jest ustawiona, kontrolka WhereLinqDataSource pobiera każdy rekord z obiektu danych.

Porządkowanie danych

Właściwość służy OrderBy do określania nazw właściwości z zwracanych danych do sortowania według.

Uwaga

Jeśli używasz kontrolki LinqDataSource z SQL Server 2000 lub SQL Server Compact 3.5, a AutoPage właściwość jest ustawiona na true, należy podać wartość we OrderBy właściwości. Domyślnie AutoPage właściwość to true. Jeśli przypiszesz wartość do Select właściwości, musisz również uwzględnić wszystkie kolumny tożsamości na liście właściwości zwracanych w zapytaniu.

Grupowanie danych

Właściwość służy do określania GroupBy , które właściwości są używane do konsolidowania rekordów danych, które mają te same wartości. Podczas grupowania danych można uwzględnić Key właściwości i It, które są dynamicznie tworzone we Select właściwości. Właściwość Key odwołuje się do wartości we właściwości lub właściwościach, które zostały użyte do grupowania danych. Jeśli na przykład pogrupujesz według właściwości o nazwie Category, Key właściwość będzie zawierać wszystkie unikatowe wartości we Category właściwości. Właściwość It odwołuje się do kolekcji pojedynczych rekordów w grupie danych. Można wykonać iterację nad właściwością It , aby pobrać poszczególne rekordy, które zostały skonsolidowane w operacji grupowania. Jeśli na przykład pogrupujesz według właściwości o nazwie Category, It właściwość zawiera wszystkie poszczególne rekordy, które współdzielą wspólną wartość we Category właściwości.

Właściwość służy do określania OrderGroupsBy właściwości do użycia do sortowania pogrupowanych danych. Podczas grupowania danych właściwość określa sposób OrderBy sortowania poszczególnych rekordów w zgrupowanych danych.

Domyślnie kontrolka LinqDataSource pobiera wartości dla wszystkich właściwości z obiektu danych. Właściwość służy do określania Select właściwości, które mają zostać zwrócone, jeśli chcesz pracować z podzbiorem dostępnych właściwości. Operacja Select jest stosowana po operacjach Where, Order By i Group By. W związku z tym w przypadku utworzenia aliasu w klauzuli Select alias alias nie jest dostępny w innych klauzulach.

Modyfikacje danych

Można określić, czy modyfikacje danych są włączone przy użyciu EnableDeletewłaściwości , EnableInserti EnableUpdate . Interfejs użytkownika do modyfikowania danych z LinqDataSource kontrolki jest zwykle udostępniany za pomocą kontrolki powiązanej z danymi, takiej jak kontrolka DetailsView . Oprócz ustawienia EnableDelete, EnableInsertlub EnableUpdate do trueprogramu wymagane są następujące warunki, aby włączyć automatyczne modyfikacje danych:

Można ograniczyć właściwości wyświetlane w kontrolce powiązanej z danymi na dwa sposoby. Możesz ustawić Select właściwość na podzbiór właściwości lub zdefiniować pola dla kontrolki powiązanej z danymi, dodając DataControlField kontrolki. Jeśli jednak ustawisz Select właściwość, oznacza to, że nie można włączyć operacji automatycznego aktualizowania, wstawiania i usuwania. Jeśli chcesz włączyć automatyczne modyfikacje danych podczas pracy z podzestawem dostępnych właściwości, nie ustawiaj Select właściwości. Zamiast tego pobierz wszystkie właściwości z obiektu danych i zarządzaj nimi przy użyciu kontrolki powiązanej z danymi. Jeśli używasz kontrolki lub kontrolki DetailsViewGridView , musisz również ustawić AutoGenerateRows właściwości lub AutoGenerateColumns na false. Zapobiega to automatycznemu dołączaniu przycisków do edycji i usuwania danych przez kontrolkę związaną z danymi. Wszystkie wartości, które nie są wyświetlane w kontrolce powiązanej z danymi, są przechowywane w stanie widoku. Są one przekazywane bez zmian do źródła danych po wykonaniu aktualizacji danych.

Ocenianie wartości w czasie wykonywania

Jeśli musisz ocenić wartości w czasie wykonywania w celu porządkowania, filtrowania lub grupowania wartości, możesz dodać parametry do WhereParameterskolekcji , GroupByParameters, OrderGroupsByParameterslub OrderByParameters .

Jeśli chcesz określić wartości domyślne, możesz dodać parametry do kolekcji InsertParameters .

Jeśli chcesz zbadać lub zmodyfikować wartości przed wykonaniem operacji danych, możesz obsłużyć Deletingzdarzenia , Inserting, Selectinglub Updating . Możesz również obsługiwać te zdarzenia, aby anulować operację danych lub sprawdzić błędy weryfikacji, które wystąpiły podczas ustawiania właściwości w klasie danych na podstawie danych wejściowych użytkownika.

Aby sprawdzić wartości po zakończeniu operacji danych, obsłuż Deletedzdarzenia , Inserted, Selectedlub Updated .

Praca z procedurami składowanymi

Kontrolka LinqDataSource służy do pobierania danych z procedury składowanej przez utworzenie procedury obsługi zdarzeń Selecting dla zdarzenia. W procedurze obsługi zdarzeń należy wywołać metodę w klasie kontekstu danych reprezentującej procedurę składowaną i ustawić wynik na Result właściwość LinqDataSourceSelectEventArgs obiektu. Jeśli chcesz włączyć operacje automatycznej aktualizacji, wstawiania i usuwania danych, typ zwracany z metody musi być zgodny z typem określonym we TableName właściwości . Aby uzyskać więcej informacji na temat tworzenia metod kontekstu danych, zobacz How to: Create DataContext methods mapped to stored procedures and functions (O/R Projektant).

Składnia deklaracyjna

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

Inicjuje nowe wystąpienie klasy LinqDataSource.

Właściwości

Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.

(Odziedziczone po Control)
AppRelativeTemplateSourceDirectory

Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę.

(Odziedziczone po Control)
AutoGenerateOrderByClause

Pobiera lub ustawia wartość wskazującą, czy LinqDataSource kontrolka dynamicznie tworzy klauzulę Order By na podstawie wartości w kolekcji OrderByParameters .

AutoGenerateWhereClause

Pobiera lub ustawia wartość wskazującą, czy LinqDataSource kontrolka dynamicznie tworzy klauzulę Where na podstawie wartości zdefiniowanych w kolekcji WhereParameters .

AutoPage

Pobiera lub ustawia wartość wskazującą, czy LinqDataSource kontrolka obsługuje nawigację przez sekcje danych w czasie wykonywania.

AutoSort

Pobiera lub ustawia wartość wskazującą, czy kontrolka LinqDataSource obsługuje sortowanie danych w czasie wykonywania.

BindingContainer

Pobiera kontrolkę zawierającą powiązanie danych tego formantu.

(Odziedziczone po Control)
ChildControlsCreated

Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET.

(Odziedziczone po DataSourceControl)
ClientIDMode

Ta właściwość nie jest używana w przypadku kontrolek źródła danych.

(Odziedziczone po DataSourceControl)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości .

(Odziedziczone po Control)
Context

HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.

(Odziedziczone po Control)
ContextTypeName

Pobiera lub ustawia nazwę typu zawierającego właściwość, której wartość zawiera dane, które chcesz pobrać.

Controls

ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.

(Odziedziczone po DataSourceControl)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement .

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement .

(Odziedziczone po Control)
DeleteParameters

Ta właściwość nie jest używana przez klasę LinqDataSource .

DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.

(Odziedziczone po Control)
EnableDelete

Pobiera lub ustawia wartość wskazującą, czy rekordy danych można usunąć za pomocą kontrolki LinqDataSource .

EnableInsert

Pobiera lub ustawia wartość wskazującą, czy rekordy danych można wstawić za pomocą kontrolki LinqDataSource .

EnableObjectTracking

Pobiera lub ustawia wartość wskazującą, czy zmiany obiektu kontekstu danych są śledzone.

EnableTheming

Pobiera wartość wskazującą, czy ta kontrolka obsługuje motywy.

(Odziedziczone po DataSourceControl)
EnableUpdate

Pobiera lub ustawia wartość wskazującą, czy rekordy danych można aktualizować za pomocą kontrolki LinqDataSource .

EnableViewState

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie.

(Odziedziczone po Control)
EntitySetName

Pobiera lub ustawia nazwę właściwości lub pola w obiekcie źródła danych, który reprezentuje kolekcję danych.

(Odziedziczone po ContextDataSource)
EntityTypeName

Pobiera lub ustawia nazwę typu utworzonego dla operacji wstawiania, usuwania i aktualizacji.

(Odziedziczone po ContextDataSource)
Events

Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu.

(Odziedziczone po Control)
GroupBy

Pobiera lub ustawia wartość określającą, które właściwości są używane do grupowania pobranych danych.

GroupByParameters

Pobiera kolekcję parametrów używanych do utworzenia klauzuli Group By.

HasChildViewState

Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku.

(Odziedziczone po Control)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontrolek.

(Odziedziczone po Control)
InsertParameters

Pobiera kolekcję parametrów używanych podczas operacji wstawiania.

IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli.

(Odziedziczone po Control)
IsTrackingViewState

Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku.

(Odziedziczone po Control)
LoadViewStateByID

Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości.

(Odziedziczone po Control)
OrderBy

Pobiera lub ustawia wartość określającą, które pola są używane do zamawiania pobranych danych.

OrderByParameters

Pobiera kolekcję parametrów używanych do utworzenia klauzuli Order By.

OrderGroupsBy

Pobiera lub ustawia pola używane do porządkowania pogrupowanych danych.

OrderGroupsByParameters

Pobiera kolekcję parametrów, które są używane do tworzenia klauzuli Order Groups By.

Page

Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami.

(Odziedziczone po Control)
RenderingCompatibility

Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny.

(Odziedziczone po Control)
Select

Pobiera lub ustawia właściwości i wartości obliczeniowe uwzględnione w pobranych danych.

SelectParameters

Pobiera kolekcję parametrów używanych podczas operacji pobierania danych.

Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej.

(Odziedziczone po Control)
SkinID

Pobiera skórę do zastosowania do kontrolki DataSourceControl .

(Odziedziczone po DataSourceControl)
StoreOriginalValuesInViewState

Pobiera lub ustawia wartość wskazującą, czy dane ze źródła danych powinny być przechowywane w stanie widoku, aby upewnić się, że dane nie zostały zmienione przez inny proces przed jego zaktualizowaniem lub usunięciem.

TableName

Pobiera lub ustawia nazwę właściwości lub pola w klasie kontekstu danych reprezentującej zbieranie danych.

TemplateControl

Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera.

(Odziedziczone po Control)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera.

(Odziedziczone po Control)
UpdateParameters

Ta kolekcja nie jest używana przez klasę LinqDataSource .

ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.

(Odziedziczone po Control)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb stanu widoku tej kontrolki.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka jest wyświetlana wizualnie.

(Odziedziczone po DataSourceControl)
Where

Pobiera lub ustawia wartość określającą, jakie warunki muszą być spełnione, aby rekord został uwzględniony w pobranych danych.

WhereParameters

Pobiera kolekcję parametrów używanych do utworzenia klauzuli Where.

Metody

AddedControl(Control, Int32)

Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera.

(Odziedziczone po Control)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.

(Odziedziczone po DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość buforowanej ClientID na nullwartość .

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość .

(Odziedziczone po Control)
CreateChildControls()

Wywoływana przez platformę strony ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania.

(Odziedziczone po Control)
CreateControlCollection()

Tworzy kolekcję do przechowywania kontrolek podrzędnych.

(Odziedziczone po DataSourceControl)
CreateQueryableView()

Zwraca widok z możliwością wykonywania zapytań.

CreateView()

Tworzy nowe wystąpienie klasy skojarzonej LinqDataSourceView z tą kontrolką.

DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.

(Odziedziczone po Control)
DataBind(Boolean)

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia.

(Odziedziczone po Control)
DataBindChildren()

Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.

(Odziedziczone po Control)
Delete(IDictionary, IDictionary)

Wykonuje operację usuwania.

Dispose()

Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Kończy śledzenie danych renderowania w czasie projektowania.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru.

(Odziedziczone po DataSourceControl)
FindControl(String, Int32)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody .

(Odziedziczone po Control)
Focus()

Ustawia fokus wejściowy na kontrolkę.

(Odziedziczone po DataSourceControl)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.

(Odziedziczone po Control)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki.

(Odziedziczone po Control)
GetView(String)

Zwraca widok źródła danych skojarzony z obiektem LinqDataSource .

GetView(String)

Pobiera widok źródła danych skojarzony z obiektem QueryableDataSource .

(Odziedziczone po QueryableDataSource)
GetViewNames()

Zwraca kolekcję nazw reprezentujących listę obiektów widoku skojarzonych z kontrolką LinqDataSource .

GetViewNames()

Pobiera kolekcję nazw reprezentujących widoki skojarzone z kontrolką QueryableDataSource .

(Odziedziczone po QueryableDataSource)
HasControls()

Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne.

(Odziedziczone po DataSourceControl)
HasEvents()

Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych.

(Odziedziczone po Control)
Insert(IDictionary)

Wykonuje operację wstawiania.

IsLiteralContent()

Określa, czy kontrolka serwera przechowuje tylko zawartość literału.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() .

(Odziedziczone po Control)
LoadViewState(Object)

Ładuje stan wartości w kontrolce LinqDataSource , która musi być utrwalone.

LoadViewState(Object)

Ładuje stan wartości w kontrolce QueryableDataSource , która musi być utrwalone.

(Odziedziczone po QueryableDataSource)
MapPathSecure(String)

Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.

(Odziedziczone po Control)
OnDataBinding(EventArgs)

DataBinding Zgłasza zdarzenie.

(Odziedziczone po Control)
OnInit(EventArgs)

Inicjuje LinqDataSource obiekt.

OnLoad(EventArgs)

Load Zgłasza zdarzenie.

(Odziedziczone po Control)
OnPreRender(EventArgs)

PreRender Zgłasza zdarzenie.

(Odziedziczone po Control)
OnUnload(EventArgs)

Unload Zgłasza zdarzenie.

OpenFile(String)

Pobiera element Stream używany do odczytywania pliku.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki.

(Odziedziczone po Control)
RaiseDataSourceChangedEvent(EventArgs)

DataSourceChanged Zgłasza zdarzenie.

(Odziedziczone po DataSourceControl)
RaiseViewChanged()

Wywołuje metodę OnDataSourceViewChanged(EventArgs)DataSourceView klasy .

(Odziedziczone po QueryableDataSource)
RemovedControl(Control)

Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.

(Odziedziczone po Control)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter)

Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone.

(Odziedziczone po DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu.

(Odziedziczone po Control)
ResolveAdapter()

Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na adres, który może być używany przez klienta żądającego.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po Control)
SaveViewState()

Zapisuje bieżący stan widoku kontrolki LinqDataSource .

SaveViewState()

Zapisuje bieżący stan widoku kontrolki QueryableDataSource .

(Odziedziczone po QueryableDataSource)
SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
TrackViewState()

Śledzi zmiany stanu widoku w kontrolce LinqDataSource , aby zmiany mogły być przechowywane w StateBag obiekcie dla kontrolki.

TrackViewState()

Śledzi zmiany stanu widoku kontrolki QueryableDataSource , aby zmiany mogły być przechowywane w StateBag obiekcie dla kontrolki.

(Odziedziczone po QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

Wykonuje operację aktualizacji.

UpdateParameterVales()

Aktualizacje wartości parametrów, które uległy zmianie od poprzedniego żądania.

(Odziedziczone po QueryableDataSource)

Zdarzenia

ContextCreated

Występuje po utworzeniu wystąpienia obiektu typu kontekstu.

ContextCreating

Występuje przed utworzeniem wystąpienia obiektu typu kontekstu.

ContextDisposing

Występuje przed dysponowaniem obiektu typu kontekstu.

DataBinding

Występuje, gdy kontrolka serwera wiąże się ze źródłem danych.

(Odziedziczone po Control)
Deleted

Występuje po zakończeniu operacji usuwania.

Deleting

Występuje przed operacją usuwania.

Disposed

Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET.

(Odziedziczone po Control)
Init

Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia.

(Odziedziczone po Control)
Inserted

Występuje po zakończeniu operacji wstawiania.

Inserting

Występuje przed operacją wstawiania.

Load

Występuje, gdy kontrolka serwera jest ładowana do Page obiektu.

(Odziedziczone po Control)
PreRender

Występuje po załadowaniu Control obiektu, ale przed renderowaniem.

(Odziedziczone po Control)
QueryCreated

Występuje po dodaniu lub usunięciu zapytania z kontrolki źródła danych.

(Odziedziczone po QueryableDataSource)
Selected

Występuje po zakończeniu operacji pobierania danych.

Selecting

Występuje przed operacją pobierania danych.

Unload

Występuje, gdy kontrolka serwera jest zwalniana z pamięci.

(Odziedziczone po Control)
Updated

Występuje po zakończeniu operacji aktualizacji.

Updating

Występuje przed operacją aktualizacji.

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego członka, zobacz ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego członka, zobacz GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings.

(Odziedziczone po Control)
IDataSource.DataSourceChanged

Występuje, gdy kontrola źródła danych zmieniła się w sposób, który wpływa na kontrolki powiązane z danymi.

(Odziedziczone po DataSourceControl)
IDataSource.GetView(String)

Pobiera nazwany DataSourceView obiekt skojarzony z kontrolką DataSourceControl . Niektóre kontrolki źródła danych obsługują tylko jeden widok, a inne obsługują więcej niż jeden widok.

(Odziedziczone po DataSourceControl)
IDataSource.GetViewNames()

Pobiera kolekcję nazw, reprezentującą listę obiektów skojarzonych DataSourceView z kontrolką DataSourceControl .

(Odziedziczone po DataSourceControl)
IDynamicDataSource.ContextType

Aby uzyskać opis tego elementu członkowskiego, zobacz IDynamicDataSource.

IDynamicDataSource.EntitySetName

Aby uzyskać opis tego elementu członkowskiego, zobacz IDynamicDataSource.

IDynamicDataSource.Exception

Aby uzyskać opis tego elementu członkowskiego, zobacz IDynamicDataSource.

IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions.

(Odziedziczone po Control)
IListSource.ContainsListCollection

Wskazuje, czy kontrolka źródła danych jest skojarzona z co najmniej jedną listą danych.

(Odziedziczone po DataSourceControl)
IListSource.GetList()

Pobiera listę kontrolek źródła danych, które mogą być używane jako źródła list danych.

(Odziedziczone po DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object).

(Odziedziczone po Control)

Metody rozszerzania

ExpandDynamicWhereParameters(IDynamicDataSource)

Rozszerza filtry dynamiczne na Where parametry, które mogą być używane przez źródło danych.

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.

FindMetaTable(Control)

Zwraca obiekt metatable dla kontrolki zawierającej dane.

GetDefaultValues(IDataSource)

Pobiera kolekcję wartości domyślnych dla określonego źródła danych.

GetMetaTable(IDataSource)

Pobiera metadane dla tabeli w określonym obiekcie źródła danych.

GetTable(IDynamicDataSource)

MetaTable Zwraca obiekt skojarzony z określoną kontrolą źródła danych.

LoadWith<TEntity>(LinqDataSource)

DataLoadOptions Ustawia wartość źródła danych LINQ-to-SQL, aby wymusić załadowanie wszystkich jednostek klucza obcego.

LoadWithForeignKeys(LinqDataSource, Type)

DataLoadOptions Ustawia wartość źródła danych LINQ-to-SQL, aby wymusić załadowanie wszystkich jednostek klucza obcego.

TryGetMetaTable(IDataSource, MetaTable)

Określa, czy metadane tabeli są dostępne.

Dotyczy

Zobacz też