LinqDataSource Класс

Определение

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

Наследование

Object

Control

DataSourceControl

LinqDataSource

Наследование

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Атрибуты

ToolboxBitmapAttribute

Реализации

IDynamicDataSource IDataSource

Примеры

В следующем примере показан LinqDataSource элемент управления, который извлекает данные из класса сущности с именем Products. Класс сущности мог быть создан с помощью Designer O/R или служебной программы SqlMetal.exe. Свойство Where возвращает только те записи, которые имеют значение в свойстве Price больше 50. Элемент GridView управления привязан к элементу LinqDataSource управления для отображения данных.

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

В следующем примере показан LinqDataSource элемент управления, позволяющий пользователям обновлять, удалять и вставлять записи в источник данных. Элемент DetailsView управления привязан к элементу LinqDataSource управления и позволяет пользователям просматривать и изменять данные. Обратите внимание, что для выбора, обновления, удаления или вставки записей не требуются команды SQL.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

В следующем примере показан обработчик событий для Selecting события, который задает объект данных на основе значения на веб-странице.

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

В следующем примере показан элемент управления, настроенный LinqDataSource для группировки по двум столбцам. Свойство Key ссылается на объект, имеющий два свойства: ProductCategory и Color. Объект, представленный , переименован (с псевдонимом It ) в Products. Переименованный Products объект содержит коллекцию отдельных записей в группировке. Каждый экземпляр будет содержать все столбцы из Products таблицы.

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

В следующем примере показаны два ListView элемента управления, отображающие данные из LinqDataSource элемента управления в предыдущем примере. В одном элементе ListView управления отображаются сгруппированные данные, а в другом ListView — отдельные имена продуктов, принадлежащих к этой группе. Свойству вложенного элемента управления DataSource с привязкой к Productsданным присваивается значение , которое является псевдонимом 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>

Комментарии

В этом разделе:

• Введение

• Порядок выполнения операций

• Упорядочение данных

• Группировка данных

• Модификации данных

• Оценка значений во время выполнения

• Работа с хранимыми процедурами

• Декларативный синтаксис

Вступление

Language-Integrated Query (LINQ) — это синтаксис запросов, определяющий набор операторов запросов, которые позволяют выполнять операции обхода, фильтрации и проекции декларативным образом в любом из . Язык программирования на основе NET. Объект данных может быть коллекцией данных в памяти или объектом, который представляет данные из базы данных. Вы можете получить или изменить данные без необходимости писать команды SQL для каждой операции.

Элемент LinqDataSource управления позволяет использовать LINQ на веб-странице ASP.NET, задавая свойства в тексте разметки. Элемент LinqDataSource управления использует LINQ to SQL для автоматического создания команд данных. Дополнительные сведения о LINQ to SQL см. в разделе LINQ to SQL.

При извлечении данных из коллекции данных в памяти присваивается свойству ContextTypeName класс, содержащий коллекцию данных. Свойство присваивается TableName свойству или полю, возвращающим коллекцию данных. Например, у вас может быть класс с именем Person , содержащий свойство с именем FavoriteCities , которое возвращает массив строковых значений. В этом случае для свойства задается ContextTypeName значение Person , а свойству TableName — значение FavoriteCities.

При запросе базы данных необходимо сначала создать классы сущностей, которые представляют базу данных и ее таблицы. Для создания этих классов можно использовать реляционный конструктор объектов или служебную программу SqlMetal.exe. Затем для свойства задается ContextTypeName класс , представляющий базу данных, и свойство TableName , представляющее таблицу базы данных.

Порядок выполнения операций

Элемент LinqDataSource управления применяет операции с данными в следующем порядке:

1. Где (укажите, какие записи данных следует возвращать).

2. Order By (sort).

3. Группировать по (агрегированные записи данных, которые совместно используют значения).

4. Упорядочить группы по (сортировка сгруппированных данных).

5. Выберите (укажите поля или свойства для возврата).

6. Автоматическая сортировка (сортировка записей данных по свойству, выбранному пользователем).

7. Автоматическая страница (получение подмножества записей данных, выбранных пользователем).

В свойство можно добавить условия Where для фильтрации записей данных, возвращаемых запросом. Where Если свойство не задано, LinqDataSource элемент управления извлекает каждую запись из объекта данных.

Упорядочение данных

Свойство используется для OrderBy указания имен свойств из возвращаемых данных для сортировки.

Группировка данных

Свойство используется для GroupBy указания свойств, используемых для консолидации записей данных с одинаковыми значениями. При группировке данных в свойство можно включить Key и It, которые являются динамически создаваемыми свойствами Select . Свойство Key ссылается на значения в свойстве или свойствах, которые использовались для группировки данных. Например, если сгруппировать по свойству с именем Category, Key свойство будет содержать все уникальные значения в свойстве Category . Свойство It ссылается на коллекцию отдельных записей в группе данных. Вы можете выполнить итерацию по свойству It , чтобы получить отдельные записи, которые были объединены в операции группировки. Например, если группировать по свойству с именем Category, It свойство содержит все отдельные записи, которые имеют общее значение в свойстве Category .

Свойство используется OrderGroupsBy для указания свойств, используемых для сортировки сгруппированных данных. При группировке OrderBy данных свойство указывает, как сортируются отдельные записи в сгруппированных данных.

По умолчанию LinqDataSource элемент управления получает значения для всех свойств из объекта данных. Свойство используется, Select чтобы указать, какие свойства следует возвращать, если вы хотите работать с подмножеством доступных свойств. Операция Select применяется после операций Where, Order By и Group By. Таким образом, если вы создаете псевдоним в предложении Select, псевдоним не будет доступен в других предложениях.

Модификации данных

Можно указать, включены ли изменения данных, с помощью EnableDeleteсвойств , EnableInsertи EnableUpdate . Пользовательский интерфейс для изменения данных из LinqDataSource элемента управления обычно предоставляется через элемент управления с привязкой к данным, например элемент управления DetailsView . Помимо установки EnableDelete, EnableInsertили EnableUpdate значения true, для включения автоматического изменения данных требуются следующие условия:

• Свойству Select нельзя присвоить значение.

• Свойству GroupBy нельзя присвоить значение.

• Класс, назначенный свойству , должен быть производным ContextTypeName от DataContext.

• Свойство, назначенное свойству, должно быть производным TableName от Table<TEntity>.

Свойства, отображаемые в элементе управления с привязкой к данным, можно ограничить двумя способами. Можно задать Select для свойства подмножество свойств или определить поля для элемента управления с привязкой к данным, добавив DataControlField элементы управления. Однако если задать Select свойство , это означает, что автоматическое обновление, вставка и удаление невозможно включить. Если вы хотите включить автоматическое изменение данных при работе с подмножеством доступных свойств, не устанавливайте Select свойство . Вместо этого извлеките все свойства из объекта данных и управляйте отображаемыми свойствами с помощью элемента управления с привязкой к данным. При использовании DetailsView элемента управления или GridView элемента управления необходимо также задать для AutoGenerateRows свойств или AutoGenerateColumns значение false. Это не позволяет элементу управления с привязкой к данным автоматически включать кнопки для редактирования и удаления данных. Все значения, которые не отображаются в элементе управления с привязкой к данным, хранятся в состоянии представления. Они передаются в источник данных без изменений при обновлении данных.

Оценка значений во время выполнения

Если необходимо оценивать значения во время выполнения для упорядочения, фильтрации или группирования значений, можно добавить параметры в WhereParametersколлекции , GroupByParameters, OrderGroupsByParametersили OrderByParameters .

Если вы хотите указать значения по умолчанию, можно добавить параметры в коллекцию InsertParameters .

Если вы хотите проверить или изменить значения перед выполнением операции с данными, можно обработать Deletingсобытия , Inserting, Selectingили Updating . Эти события также можно обрабатывать, чтобы отменить операцию с данными или изучить ошибки проверки, возникшие при задании свойств в классе данных на основе введенных пользователем данных.

Чтобы проверить значения после завершения операции с данными, обработайте Deletedсобытия , Inserted, Selectedили Updated .

Работа с хранимыми процедурами

Элемент управления используется LinqDataSource для получения данных из хранимой процедуры путем создания обработчика Selecting событий для события. В обработчике событий вызывается метод в классе контекста LinqDataSourceSelectEventArgs данных, который представляет хранимую процедуру, и присваивается результату Result свойство объекта . Если вы хотите включить операции автоматического обновления, вставки и удаления данных, тип, возвращаемый методом, должен соответствовать типу, указанному в свойстве TableName . Дополнительные сведения о создании методов контекста данных см. в разделе Практическое руководство. Создание методов DataContext, сопоставленных с хранимыми процедурами и функциями (O/R Designer).

Декларативный синтаксис

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

Конструкторы

Свойства

Методы

События

Явные реализации интерфейса

Методы расширения

Применяется к

См. также раздел

• LINQ to SQL