LinqDataSource Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Consente l'uso di Language-Integrated Query (LINQ) in una pagina Web ASP.NET tramite testo di markup per recuperare e modificare i dati da un oggetto dati.

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

Ereditarietà

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Attributi

ToolboxBitmapAttribute

Implementazioni

IDynamicDataSource IDataSource

Esempio

Nell'esempio seguente viene illustrato un LinqDataSource controllo che recupera i dati da una classe di entità denominata Products. La classe di entità potrebbe essere stata generata usando O/R Designer o l'utilità di SqlMetal.exe. La Where proprietà è impostata per restituire solo i record con un valore nella Price proprietà maggiore di 50. Un GridView controllo è associato al LinqDataSource controllo per visualizzare i dati.

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

Nell'esempio seguente viene illustrato un LinqDataSource controllo che consente agli utenti di aggiornare, eliminare e inserire record nell'origine dati. Un DetailsView controllo è associato al LinqDataSource controllo e consente agli utenti di visualizzare e modificare i dati. Si noti che non sono necessari comandi SQL per selezionare, aggiornare, eliminare o inserire i record.

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

Nell'esempio seguente viene illustrato un gestore eventi per l'evento che imposta l'oggetto Selecting dati in base a un valore nella pagina 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

Nell'esempio seguente viene illustrato un LinqDataSource controllo configurato per il raggruppamento in base a due colonne. La Key proprietà fa riferimento a un oggetto con due proprietà e ProductCategoryColor. L'oggetto rappresentato da It viene rinominato (aliasato) in Products. L'oggetto rinominato Products contiene una raccolta di singoli record in un raggruppamento. Ogni istanza conterrà tutte le colonne della Products tabella.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

Nell'esempio seguente vengono illustrati due ListView controlli che visualizzano i dati del LinqDataSource controllo nell'esempio precedente. Un ListView controllo visualizza i dati raggruppati e l'altro ListView controllo visualizza i singoli nomi dei prodotti che appartengono a tale gruppo. La proprietà del DataSource controllo con associazione a dati annidata è impostata su Products, ovvero l'alias per l'oggetto It .

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>

<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Commenti

In questo argomento:

• Introduzione

• Ordine delle operazioni

• Ordinamento dei dati

• Raggruppamento di dati

• Modifiche ai dati

• Valutazione dei valori in fase di esecuzione

• Utilizzo di stored procedure

• Sintassi dichiarativa

Introduzione

Language-Integrated Query (LINQ) è una sintassi di query che definisce un set di operatori di query che consentono l'espressione di operazioni di attraversamento, filtro e proiezione in modo dichiarativo in qualsiasi oggetto . Linguaggio di programmazione basato su NET. L'oggetto dati può essere una raccolta di dati in memoria o un oggetto che rappresenta i dati di un database. È possibile recuperare o modificare i dati senza dover scrivere comandi SQL per ogni operazione.

Il LinqDataSource controllo consente di usare LINQ in una pagina Web ASP.NET impostando le proprietà nel testo di markup. Il LinqDataSource controllo usa LINQ to SQL per generare automaticamente i comandi dati. Per altre informazioni su LINQ to SQL, vedere LINQ to SQL.

Quando si recuperano dati da una raccolta di dati in memoria, impostare la ContextTypeName proprietà sulla classe che contiene la raccolta dati. Impostare la TableName proprietà sulla proprietà o sul campo che restituisce la raccolta dati. Ad esempio, potrebbe essere presente una classe denominata Person che contiene una proprietà denominata FavoriteCities che restituisce una matrice di valori stringa. In tal caso, impostare la ContextTypeName proprietà su Person e impostare la TableName proprietà su FavoriteCities.

Quando si esegue una query su un database, è prima necessario creare classi di entità che rappresentano il database e le relative tabelle. È possibile usare Progettazione relazionale oggetti o l'utilità SqlMetal.exe per generare queste classi. Impostare quindi la ContextTypeName proprietà sulla classe che rappresenta il database e impostare la TableName proprietà sulla proprietà che rappresenta la tabella di database.

Ordine delle operazioni

Il LinqDataSource controllo applica le operazioni sui dati nell'ordine seguente:

1. Dove (specificare i record di dati da restituire).

2. Ordina per (ordinamento).

3. Raggruppa per (aggregare i record di dati che condividono valori).

4. Ordinare i gruppi per (ordinare i dati raggruppati).

5. Selezionare (specificare i campi o le proprietà da restituire).

6. Ordinamento automatico (ordinare i record di dati in base a una proprietà selezionata dall'utente).

7. Pagina automatica (recuperare un subset di record di dati selezionati dall'utente).

È possibile aggiungere condizioni alla Where proprietà per filtrare i record di dati restituiti da una query. Se la Where proprietà non è impostata, il LinqDataSource controllo recupera ogni record dall'oggetto dati.

Ordinamento dei dati

Utilizzare la OrderBy proprietà per specificare i nomi delle proprietà dai dati restituiti per l'ordinamento.

Annotazioni

Quando si usa il LinqDataSource controllo con SQL Server 2000 o SQL Server Compact 3.5 e la AutoPage proprietà è impostata su true, è necessario specificare un valore nella OrderBy proprietà . Per impostazione predefinita, la proprietà AutoPage è true. Se si assegna un valore alla Select proprietà , è necessario includere anche tutte le colonne Identity nell'elenco delle proprietà restituite nella query.

Raggruppamento dei dati

Utilizzare la GroupBy proprietà per specificare le proprietà utilizzate per consolidare i record di dati con gli stessi valori. Quando si raggruppano i dati, è possibile includere Key e It, che sono proprietà create dinamicamente, nella Select proprietà . La Key proprietà fa riferimento ai valori nella proprietà o nelle proprietà utilizzate per raggruppare i dati. Ad esempio, se si raggruppa in base a una proprietà denominata Category, la Key proprietà conterrà tutti i valori univoci nella Category proprietà . La It proprietà fa riferimento a una raccolta di singoli record in un raggruppamento di dati. È possibile eseguire l'iterazione sulla It proprietà per recuperare i singoli record consolidati nell'operazione di raggruppamento. Ad esempio, se si raggruppa in base a una proprietà denominata Category, la It proprietà contiene tutti i singoli record che condividono un valore comune nella Category proprietà .

Utilizzare la OrderGroupsBy proprietà per specificare le proprietà da utilizzare per l'ordinamento dei dati raggruppati. Quando si raggruppano i dati, la OrderBy proprietà specifica la modalità di ordinamento dei singoli record all'interno dei dati raggruppati.

Per impostazione predefinita, il LinqDataSource controllo recupera i valori per tutte le proprietà da un oggetto dati. Utilizzare la Select proprietà per specificare le proprietà da restituire se si desidera utilizzare un subset di proprietà disponibili. L'operazione Select viene applicata dopo le operazioni Where, Order By e Group By. Pertanto, se si crea un nome con alias in una clausola Select, l'alias non è disponibile nelle altre clausole.

Modifiche ai dati

È possibile specificare se le modifiche ai dati sono abilitate usando le EnableDeleteproprietà , EnableInserte EnableUpdate . L'interfaccia utente per la modifica dei dati da un LinqDataSource controllo viene in genere fornita tramite un controllo associato a dati, ad esempio un DetailsView controllo . Oltre a impostare EnableDelete, EnableInserto EnableUpdate su true, sono necessarie le condizioni seguenti per abilitare le modifiche automatiche ai dati:

• Non Select è possibile assegnare alla proprietà un valore.

• Non GroupBy è possibile assegnare alla proprietà un valore.

• La classe assegnata alla ContextTypeName proprietà deve derivare da DataContext.

• La proprietà assegnata alla TableName proprietà deve derivare da Table<TEntity>.

È possibile limitare le proprietà visualizzate in un controllo associato a dati in due modi. È possibile impostare la Select proprietà su un subset di proprietà oppure definire i campi per un controllo associato a dati aggiungendo DataControlField controlli. Tuttavia, se si imposta la Select proprietà , significa che le operazioni di aggiornamento automatico, inserimento ed eliminazione non possono essere abilitate. Se si desidera abilitare le modifiche automatiche dei dati mentre si lavora con un subset di proprietà disponibili, non impostare la Select proprietà . Recuperare invece tutte le proprietà dall'oggetto dati e gestire quelle visualizzate usando il controllo associato a dati. Quando si utilizza il DetailsView controllo o il GridView controllo , è necessario impostare anche le AutoGenerateRows proprietà o AutoGenerateColumns su false. Ciò impedisce al controllo associato a dati di includere automaticamente pulsanti per la modifica e l'eliminazione dei dati. Tutti i valori non visualizzati nel controllo associato a dati vengono archiviati nello stato di visualizzazione. Vengono passati invariati all'origine dati quando viene eseguito l'aggiornamento dei dati.

Valutazione dei valori in fase di esecuzione

Se è necessario valutare i valori in fase di esecuzione per ordinare, filtrare o raggruppare i valori, è possibile aggiungere parametri alle WhereParametersraccolte , GroupByParameters, OrderGroupsByParameterso OrderByParameters .

Se si desidera specificare i valori predefiniti, è possibile aggiungere parametri alla InsertParameters raccolta.

Se si desidera esaminare o modificare i valori prima dell'esecuzione dell'operazione di dati, è possibile gestire gli Deletingeventi , InsertingSelecting, o Updating . È anche possibile gestire questi eventi per annullare l'operazione sui dati o per esaminare gli errori di convalida che si sono verificati quando si impostano le proprietà nella classe di dati in base all'input dell'utente.

Per esaminare i valori al termine dell'operazione dati, gestire gli Deletedeventi , SelectedInserted, o Updated .

Utilizzo di stored procedure

Il controllo consente di LinqDataSource recuperare i dati da una stored procedure creando un gestore eventi per l'evento Selecting . Nel gestore eventi chiamare il metodo nella classe contesto dati che rappresenta la stored procedure e impostare il risultato sulla Result proprietà dell'oggetto LinqDataSourceSelectEventArgs . Se si desidera abilitare operazioni di aggiornamento automatico, inserimento ed eliminazione per i dati, il tipo restituito dal metodo deve corrispondere al tipo specificato nella TableName proprietà . Per altre informazioni sulla creazione di metodi del contesto dati, vedere Procedura: Creare metodi DataContext mappati a stored procedure e funzioni (O/R Designer).

Sintassi dichiarativa

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

Costruttori

Nome	Descrizione
LinqDataSource()	Inizializza una nuova istanza della classe LinqDataSource.

Proprietà

Nome	Descrizione
Adapter	Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control)
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control)
AutoGenerateOrderByClause	Ottiene o imposta un valore che indica se il LinqDataSource controllo crea dinamicamente una clausola Order By in base ai valori dell'insieme OrderByParameters .
AutoGenerateWhereClause	Ottiene o imposta un valore che indica se il LinqDataSource controllo crea dinamicamente una clausola Where in base ai valori definiti nella WhereParameters raccolta.
AutoPage	Ottiene o imposta un valore che indica se il controllo supporta lo LinqDataSource spostamento tra sezioni dei dati in fase di esecuzione.
AutoSort	Ottiene o imposta un valore che indica se il controllo supporta l'ordinamento LinqDataSource dei dati in fase di esecuzione.
BindingContainer	Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control)
ChildControlsCreated	Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control)
ClientID	Ottiene l'identificatore del controllo server generato da ASP.NET. (Ereditato da DataSourceControl)
ClientIDMode	Questa proprietà non viene utilizzata per i controlli origine dati. (Ereditato da DataSourceControl)
ClientIDSeparator	Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
ContextTypeName	Ottiene o imposta il nome del tipo che contiene la proprietà il cui valore contiene i dati da recuperare.
Controls	Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da DataSourceControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DeleteParameters	Questa proprietà non viene utilizzata dalla LinqDataSource classe .
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
EnableDelete	Ottiene o imposta un valore che indica se i record di dati possono essere eliminati tramite il LinqDataSource controllo .
EnableInsert	Ottiene o imposta un valore che indica se i record di dati possono essere inseriti tramite il LinqDataSource controllo .
EnableObjectTracking	Ottiene o imposta il valore che indica se vengono rilevate modifiche all'oggetto contesto dati.
EnableTheming	Ottiene un valore che indica se questo controllo supporta i temi. (Ereditato da DataSourceControl)
EnableUpdate	Ottiene o imposta un valore che indica se i record di dati possono essere aggiornati tramite il LinqDataSource controllo .
EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control)
EntitySetName	Ottiene o imposta il nome della proprietà o del campo nell'oggetto origine dati che rappresenta una raccolta dati. (Ereditato da ContextDataSource)
EntityTypeName	Ottiene o imposta il nome del tipo creato per le operazioni Insert, Delete e Update. (Ereditato da ContextDataSource)
Events	Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control)
GroupBy	Ottiene o imposta un valore che specifica le proprietà utilizzate per raggruppare i dati recuperati.
GroupByParameters	Ottiene la raccolta di parametri utilizzati per creare la clausola Group By.
HasChildViewState	Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
ID	Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
InsertParameters	Ottiene la raccolta di parametri utilizzati durante un'operazione di inserimento.
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control)
LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control)
OrderBy	Ottiene o imposta un valore che specifica i campi utilizzati per ordinare i dati recuperati.
OrderByParameters	Ottiene la raccolta di parametri utilizzati per creare la clausola Order By.
OrderGroupsBy	Ottiene o imposta i campi utilizzati per ordinare i dati raggruppati.
OrderGroupsByParameters	Ottiene la raccolta di parametri utilizzati per creare la clausola Order Groups By.
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control)
Select	Ottiene o imposta le proprietà e i valori calcolati inclusi nei dati recuperati.
SelectParameters	Ottiene la raccolta di parametri utilizzati durante un'operazione di recupero dati.
Site	Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene l'interfaccia da applicare al DataSourceControl controllo. (Ereditato da DataSourceControl)
StoreOriginalValuesInViewState	Ottiene o imposta un valore che indica se i dati dell'origine dati devono essere archiviati nello stato di visualizzazione per assicurarsi che i dati non siano stati modificati da un altro processo prima che vengano aggiornati o eliminati.
TableName	Ottiene o imposta il nome della proprietà o del campo nella classe del contesto dati che rappresenta una raccolta di dati.
TemplateControl	Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control)
UniqueID	Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control)
UpdateParameters	Questa raccolta non viene utilizzata dalla LinqDataSource classe .
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se il controllo viene visualizzato visivamente. (Ereditato da DataSourceControl)
Where	Ottiene o imposta un valore che specifica quali condizioni devono essere vere per includere un record nei dati recuperati.
WhereParameters	Ottiene la raccolta di parametri utilizzati per creare la clausola Where.

Metodi

Nome	Descrizione
AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control)
ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella ClientID cache su null. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
CreateChildControls()	Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control)
CreateControlCollection()	Crea una raccolta per archiviare i controlli figlio. (Ereditato da DataSourceControl)
CreateQueryableView()	Restituisce una vista queryable.
CreateView()	Crea una nuova istanza della LinqDataSourceView classe associata a questo controllo.
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
DataBind(Boolean)	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control)
DataBindChildren()	Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
Delete(IDictionary, IDictionary)	Esegue un'operazione di eliminazione.
Dispose()	Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato id e un numero intero, specificato nel pathOffset parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato id . (Ereditato da DataSourceControl)
Focus()	Imposta lo stato attivo per l'input sul controllo. (Ereditato da DataSourceControl)
GetDesignModeState()	Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control)
GetView(String)	Ottiene la vista origine dati associata all'oggetto QueryableDataSource . (Ereditato da QueryableDataSource)
GetViewNames()	Ottiene una raccolta di nomi che rappresentano le visualizzazioni associate al QueryableDataSource controllo . (Ereditato da QueryableDataSource)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da DataSourceControl)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control)
Insert(IDictionary)	Esegue un'operazione di inserimento.
IsLiteralContent()	Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control)
LoadViewState(Object)	Carica lo stato dei valori nel QueryableDataSource controllo che deve essere salvato in modo permanente. (Ereditato da QueryableDataSource)
MapPathSecure(String)	Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnInit(EventArgs)	Inizializza l'oggetto LinqDataSource.
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnPreRender(EventArgs)	Genera l'evento PreRender. (Ereditato da Control)
OnUnload(EventArgs)	Genera l'evento Unload.
OpenFile(String)	Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)	Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control)
RaiseDataSourceChangedEvent(EventArgs)	Genera l'evento DataSourceChanged. (Ereditato da DataSourceControl)
RaiseViewChanged()	Chiama il OnDataSourceViewChanged(EventArgs) metodo della DataSourceView classe . (Ereditato da QueryableDataSource)
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control)
Render(HtmlTextWriter)	Invia il contenuto del controllo server a un oggetto specificato HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da DataSourceControl)
ResolveAdapter()	Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control)
SaveControlState()	Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control)
SaveViewState()	Salva lo stato di visualizzazione corrente del QueryableDataSource controllo. (Ereditato da QueryableDataSource)
SetDesignModeState(IDictionary)	Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Tiene traccia delle modifiche dello stato di visualizzazione del QueryableDataSource controllo in modo che le modifiche possano essere archiviate nell'oggetto StateBag per il controllo. (Ereditato da QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)	Esegue un'operazione di aggiornamento.
UpdateParameterVales()	Aggiorna i valori dei parametri modificati dopo la richiesta precedente. (Ereditato da QueryableDataSource)

Eventi

Nome	Descrizione
ContextCreated	Si verifica dopo la creazione di un'istanza dell'oggetto tipo di contesto.
ContextCreating	Si verifica prima della creazione di un'istanza dell'oggetto tipo di contesto.
ContextDisposing	Si verifica prima di eliminare l'oggetto del tipo di contesto.
DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Deleted	Si verifica al termine di un'operazione di eliminazione.
Deleting	Si verifica prima di un'operazione di eliminazione.
Disposed	Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control)
Inserted	Si verifica al termine di un'operazione di inserimento.
Inserting	Si verifica prima di un'operazione di inserimento.
Load	Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control)
QueryCreated	Si verifica quando una query viene aggiunta o rimossa da un controllo origine dati. (Ereditato da QueryableDataSource)
Selected	Si verifica al termine di un'operazione di recupero dati.
Selecting	Si verifica prima di un'operazione di recupero dati.
Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)
Updated	Si verifica al termine di un'operazione di aggiornamento.
Updating	Si verifica prima di un'operazione di aggiornamento.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IDataSource.DataSourceChanged	Si verifica quando un controllo origine dati è stato modificato in modo da influire sui controlli associati a dati. (Ereditato da DataSourceControl)
IDataSource.GetView(String)	Ottiene l'oggetto denominato DataSourceView associato al DataSourceControl controllo . Alcuni controlli origine dati supportano una sola visualizzazione, mentre altri supportano più di uno. (Ereditato da DataSourceControl)
IDataSource.GetViewNames()	Ottiene una raccolta di nomi, che rappresenta l'elenco di DataSourceView oggetti associati al DataSourceControl controllo . (Ereditato da DataSourceControl)
IDynamicDataSource.ContextType	Per una descrizione di questo membro, vedere IDynamicDataSource.
IDynamicDataSource.EntitySetName	Per una descrizione di questo membro, vedere IDynamicDataSource.
IDynamicDataSource.Exception	Per una descrizione di questo membro, vedere IDynamicDataSource.
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IListSource.ContainsListCollection	Indica se il controllo origine dati è associato a uno o più elenchi di dati. (Ereditato da DataSourceControl)
IListSource.GetList()	Ottiene un elenco di controlli origine dati che possono essere utilizzati come origini di elenchi di dati. (Ereditato da DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)

Metodi di estensione

Nome	Descrizione
ExpandDynamicWhereParameters(IDynamicDataSource)	Espande i filtri dinamici in Where parametri utilizzabili dall'origine dati.
FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatable per il controllo dati contenitore.
GetDefaultValues(IDataSource)	Ottiene la raccolta dei valori predefiniti per l'origine dati specificata.
GetMetaTable(IDataSource)	Ottiene i metadati per una tabella nell'oggetto origine dati specificato.
GetTable(IDynamicDataSource)	Restituisce l'oggetto MetaTable associato al controllo origine dati specificato.
LoadWith<TEntity>(LinqDataSource)	Imposta il valore di un'origine DataLoadOptions dati LINQ-to-SQL per forzare il caricamento di tutte le entità di chiave esterna.
LoadWithForeignKeys(LinqDataSource, Type)	Imposta il valore di un'origine DataLoadOptions dati LINQ-to-SQL per forzare il caricamento di tutte le entità di chiave esterna.
TryGetMetaTable(IDataSource, MetaTable)	Determina se i metadati della tabella sono disponibili.

Vedi anche

• LINQ to SQL