LinqDataSource Klasse

Definition

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

Vererbung

Object

Control

DataSourceControl

LinqDataSource

Vererbung

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Attribute

ToolboxBitmapAttribute

Implementiert

IDynamicDataSource IDataSource

Beispiele

Das folgende Beispiel zeigt ein LinqDataSource Steuerelement, das Daten aus einer Entitätsklasse mit dem Namen Productsabruft. Die Entitätsklasse konnte mithilfe des O/R-Designer oder des Hilfsprogramms SqlMetal.exe generiert werden. Die Where Eigenschaft wird so festgelegt, dass nur Datensätze zurückgegeben werden, die einen Wert in der Price Eigenschaft größer als 50 aufweisen. Ein GridView Steuerelement ist an das LinqDataSource Steuerelement gebunden, um die Daten anzuzeigen.

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

Das folgende Beispiel zeigt ein LinqDataSource Steuerelement, mit dem Benutzer Datensätze in der Datenquelle aktualisieren, löschen und einfügen können. Ein DetailsView Steuerelement ist an das LinqDataSource Steuerelement gebunden und ermöglicht es Benutzern, die Daten anzuzeigen und zu ändern. Beachten Sie, dass keine SQL-Befehle erforderlich sind, um die Datensätze auszuwählen, zu aktualisieren, zu löschen oder einzufügen.

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

Das folgende Beispiel zeigt einen Ereignishandler für das Selecting Ereignis, das das Datenobjekt basierend auf einem Wert auf der Webseite festlegt.

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

Das folgende Beispiel zeigt ein LinqDataSource Steuerelement, das für die Gruppierung durch zwei Spalten konfiguriert ist. Die Key -Eigenschaft verweist auf ein Objekt mit zwei Eigenschaften und ColorProductCategory . Das von It dargestellte Objekt wird in umbenannt (aliased) in Products. Das umbenannte Products Objekt enthält eine Auflistung der einzelnen Datensätze in einer Gruppierung. Jede instance enthält alle Spalten aus der Products Tabelle.

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

Das folgende Beispiel zeigt zwei ListView Steuerelemente, die die Daten aus dem LinqDataSource Steuerelement im vorherigen Beispiel anzeigen. Ein ListView Steuerelement zeigt die gruppierten Daten an, und das andere ListView Steuerelement zeigt die einzelnen Namen der Produkte an, die zu dieser Gruppe gehören. Die Eigenschaft des DataSource geschachtelten datengebundenen Steuerelements ist auf festgelegt, wobei es sich um Productsden Alias für das It Objekt handelt.

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

Hinweise

In diesem Thema:

• Introduction (Einführung)

• Reihenfolge der Operationen

• Daten bestellen

• Gruppieren von Daten

• Datenänderungen

• Werte zur Laufzeit auswerten

• Arbeiten mit gespeicherten Prozeduren

• Deklarative Syntax

Einführung

Language-Integrated Query (LINQ) ist eine Abfragesyntax, die eine Reihe von Abfrageoperatoren definiert, mit denen Traversal-, Filter- und Projektionsvorgänge in einer beliebigen -Klasse deklarativ ausgedrückt werden können. NET-basierte Programmiersprache. Das Datenobjekt kann eine In-Memory-Datensammlung oder ein Objekt sein, das Daten aus einer Datenbank darstellt. Sie können die Daten abrufen oder ändern, ohne sql-Befehle für jeden Vorgang schreiben zu müssen.

Mit dem LinqDataSource Steuerelement können Sie LINQ in einer ASP.NET Webseite verwenden, indem Sie Eigenschaften im Markuptext festlegen. Das LinqDataSource Steuerelement verwendet LINQ to SQL, um die Datenbefehle automatisch zu generieren. Weitere Informationen zu LINQ to SQL finden Sie unter LINQ to SQL.

Wenn Sie Daten aus einer In-Memory-Datensammlung abrufen, legen Sie die ContextTypeName -Eigenschaft auf die -Klasse fest, die die Datensammlung enthält. Sie legen die TableName Eigenschaft auf die Eigenschaft oder das Feld fest, das die Datensammlung zurückgibt. Beispielsweise verfügen Sie über eine Klasse namens Person , die eine Eigenschaft mit dem Namen FavoriteCities enthält, die ein Array von Zeichenfolgenwerten zurückgibt. In diesem Fall legen Sie die ContextTypeName -Eigenschaft auf Person und legen die TableName -Eigenschaft auf fest FavoriteCities.

Wenn Sie eine Datenbank abfragen, müssen Sie zunächst Entitätsklassen erstellen, die die Datenbank und ihre Tabellen darstellen. Sie können die Objektrelationaler Designer oder das Hilfsprogramm SqlMetal.exe verwenden, um diese Klassen zu generieren. Anschließend legen Sie die ContextTypeName -Eigenschaft auf die -Klasse fest, die die Datenbank darstellt, und legen die TableName -Eigenschaft auf die -Eigenschaft fest, die die Datenbanktabelle darstellt.

Reihenfolge der Operationen

Das LinqDataSource Steuerelement wendet Datenvorgänge in der folgenden Reihenfolge an:

1. Where (geben Sie an, welche Datensätze zurückgegeben werden sollen).

2. Sortieren nach (Sortieren).

3. Gruppieren nach (Aggregieren von Datensätzen, die Werte gemeinsam haben).

4. Sortieren von Gruppen nach (Sortieren gruppierter Daten).

5. Wählen Sie aus (geben Sie an, welche Felder oder Eigenschaften zurückgegeben werden sollen).

6. Automatische Sortierung (Sortieren von Datensätzen nach einer Eigenschaft, die der Benutzer ausgewählt hat).

7. Automatische Seite (Ruft eine Teilmenge der Datensätze ab, die vom Benutzer ausgewählt wurden).

Sie können der Where -Eigenschaft Bedingungen hinzufügen, um die Datensätze zu filtern, die von einer Abfrage zurückgegeben werden. Wenn die Where -Eigenschaft nicht festgelegt ist, ruft das LinqDataSource Steuerelement jeden Datensatz aus dem Datenobjekt ab.

Daten bestellen

Sie verwenden die OrderBy -Eigenschaft, um die Namen der Eigenschaften aus den zurückgegebenen Daten anzugeben, nach der sortiert werden soll.

Gruppieren von Daten

Sie verwenden die GroupBy -Eigenschaft, um anzugeben, welche Eigenschaften zum Konsolidieren von Datensätzen mit den gleichen Werten verwendet werden. Wenn Sie Daten gruppieren, können Sie und Itin die Select Eigenschaft einschließenKey, bei denen es sich um dynamisch erstellte Eigenschaften handelt. Die Key -Eigenschaft bezieht sich auf die Werte in der Eigenschaft oder den Eigenschaften, die zum Gruppieren der Daten verwendet wurden. Wenn Sie beispielsweise nach einer Eigenschaft mit dem Namen Categorygruppieren, enthält die Key Eigenschaft alle eindeutigen Werte in der Category Eigenschaft. Die It -Eigenschaft bezieht sich auf eine Auflistung einzelner Datensätze in einer Datengruppierung. Sie können die It -Eigenschaft durchlaufen, um die einzelnen Datensätze abzurufen, die im Gruppierungsvorgang konsolidiert wurden. Wenn Sie beispielsweise nach einer Eigenschaft mit dem Namen Categorygruppieren, enthält die It -Eigenschaft alle einzelnen Datensätze, die einen gemeinsamen Wert in der Category Eigenschaft verwenden.

Sie verwenden die OrderGroupsBy -Eigenschaft, um die Eigenschaften anzugeben, die zum Sortieren der gruppierten Daten verwendet werden sollen. Wenn Sie Daten gruppieren, gibt die OrderBy -Eigenschaft an, wie die einzelnen Datensätze innerhalb der gruppierten Daten sortiert werden.

Standardmäßig ruft das LinqDataSource Steuerelement Werte für alle Eigenschaften aus einem Datenobjekt ab. Sie verwenden die Select -Eigenschaft, um anzugeben, welche Eigenschaften zurückgegeben werden sollen, wenn Sie mit einer Teilmenge der verfügbaren Eigenschaften arbeiten möchten. Der Select-Vorgang wird nach den Vorgängen Where, Order By und Group By angewendet. Wenn Sie daher einen Aliasnamen in einer Select-Klausel erstellen, ist der Alias in den anderen Klauseln nicht verfügbar.

Datenänderungen

Sie können angeben, ob Datenänderungen aktiviert sind, indem Sie die EnableDeleteEigenschaften , EnableInsertund EnableUpdate verwenden. Die Benutzeroberfläche zum Ändern von Daten aus einem LinqDataSource Steuerelement wird in der Regel über ein datengebundenes Steuerelement bereitgestellt, z. B. ein DetailsView -Steuerelement. Zusätzlich zum Festlegen EnableDeletevon , EnableInsertoder EnableUpdate auf truesind die folgenden Bedingungen erforderlich, um automatische Datenänderungen zu aktivieren:

• Der Select Eigenschaft kann kein Wert zugewiesen werden.

• Der GroupBy Eigenschaft kann kein Wert zugewiesen werden.

• Die -Klasse, die der ContextTypeName -Eigenschaft zugewiesen ist, muss von abgeleitet werden DataContext.

• Die -Eigenschaft, die der TableName -Eigenschaft zugewiesen ist, muss von abgeleitet werden Table<TEntity>.

Sie können einschränken, welche Eigenschaften in einem datengebundenen Steuerelement auf zwei Arten angezeigt werden. Sie können die Select Eigenschaft entweder auf eine Teilmenge von Eigenschaften festlegen, oder Sie können die Felder für ein datengebundenes Steuerelement definieren, indem Sie Steuerelemente hinzufügen DataControlField . Wenn Sie die -Eigenschaft festlegen, bedeutet dies Select jedoch, dass automatische Aktualisierungs-, Einfüge- und Löschvorgänge nicht aktiviert werden können. Wenn Sie automatische Datenänderungen aktivieren möchten, während Sie mit einer Teilmenge der verfügbaren Eigenschaften arbeiten, legen Sie die Select -Eigenschaft nicht fest. Rufen Sie stattdessen alle Eigenschaften aus dem Datenobjekt ab, und verwalten Sie mithilfe des datengebundenen Steuerelements, welche angezeigt werden. Wenn Sie das DetailsView -Steuerelement oder das GridView -Steuerelement verwenden, müssen Sie auch die AutoGenerateRows Eigenschaften oder AutoGenerateColumns auf falsefestlegen. Dadurch wird verhindert, dass das datengebundene Steuerelement automatisch Schaltflächen zum Bearbeiten und Löschen der Daten einschließt. Alle Werte, die im datengebundenen Steuerelement nicht angezeigt werden, werden im Ansichtszustand gespeichert. Sie werden unverändert an die Datenquelle übergeben, wenn die Datenaktualisierung ausgeführt wird.

Werte zur Laufzeit auswerten

Wenn Sie Werte zur Laufzeit zum Sortieren, Filtern oder Gruppieren von Werten auswerten müssen, können Sie den WhereParametersSammlungen , , GroupByParametersOrderGroupsByParametersoder OrderByParameters Parameter hinzufügen.

Wenn Sie Standardwerte angeben möchten, können Sie der InsertParameters Auflistung Parameter hinzufügen.

Wenn Sie Werte untersuchen oder ändern möchten, bevor der Datenvorgang ausgeführt wird, können Sie die DeletingEreignisse , Inserting, Selectingoder Updating behandeln. Sie können diese Ereignisse auch behandeln, um den Datenvorgang abzubrechen oder Validierungsfehler zu untersuchen, die beim Festlegen von Eigenschaften in der Datenklasse basierend auf Benutzereingaben aufgetreten sind.

Um Werte zu untersuchen, nachdem der Datenvorgang abgeschlossen ist, behandeln Sie die DeletedEreignisse , Inserted, Selectedoder Updated .

Arbeiten mit gespeicherten Prozeduren

Sie verwenden das LinqDataSource -Steuerelement, um Daten aus einer gespeicherten Prozedur abzurufen, indem Sie einen Ereignishandler für das Selecting Ereignis erstellen. Im Ereignishandler rufen Sie die -Methode in der Datenkontextklasse auf, die die gespeicherte Prozedur darstellt, und legen das Ergebnis auf die Result -Eigenschaft des LinqDataSourceSelectEventArgs -Objekts fest. Wenn Sie automatische Aktualisierungs-, Einfüge- und Löschvorgänge für die Daten aktivieren möchten, muss der typ, der von der -Methode zurückgegeben wird, mit dem in der TableName -Eigenschaft angegebenen Typ übereinstimmen. Weitere Informationen zum Erstellen von Datenkontextmethoden finden Sie unter Vorgehensweise: Erstellen von DataContext-Methoden, die gespeicherten Prozeduren und Funktionen zugeordnet sind (O/R-Designer).

Deklarative Syntax

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

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• LINQ to SQL