LinqDataSource Класс

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.Extensions.dll

Позволяет использовать запрос Language-Integrated (LINQ) на веб-странице ASP.NET с помощью текста разметки для извлечения и изменения данных из объекта данных.

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

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

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Атрибуты

ToolboxBitmapAttribute

Реализации

IDynamicDataSource IDataSource

Примеры

В следующем примере показан LinqDataSource элемент управления, который извлекает данные из класса сущности с именем Products. Класс сущности мог быть создан с помощью конструктора 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 запрос (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. Порядок по (сортировка).

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

4. Группы заказов по (отсортированные сгруппированные данные).

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

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

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

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

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

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

Замечание

При использовании LinqDataSource элемента управления с SQL Server 2000 или SQL Server Compact 3.5 и AutoPage свойством задано trueзначение, необходимо указать значение в свойстве OrderBy . По умолчанию свойство AutoPage равно true. При назначении значения Select свойству необходимо также включить все столбцы удостоверений в список свойств, возвращаемых в запросе.

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

Свойство используется 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свойств и EnableUpdate свойствEnableInsert. Пользовательский интерфейс для изменения данных из LinqDataSource элемента управления обычно предоставляется через элемент управления с привязкой к данным, например DetailsView элемент управления. Помимо параметров EnableDeleteили EnableInsertEnableUpdatetrueусловий, необходимы следующие условия для включения автоматических изменений данных:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имя	Описание
LinqDataSource()	Инициализирует новый экземпляр класса LinqDataSource.

Свойства

Имя	Описание
Adapter	Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control)
AppRelativeTemplateSourceDirectory	Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control)
AutoGenerateOrderByClause	Возвращает или задает значение, указывающее, динамически ли LinqDataSource элемент управления создает предложение Order By на основе значений OrderByParameters в коллекции.
AutoGenerateWhereClause	Возвращает или задает значение, указывающее, динамически ли LinqDataSource элемент управления создает предложение Where на основе значений, определенных в WhereParameters коллекции.
AutoPage	Возвращает или задает значение, указывающее, поддерживает ли LinqDataSource элемент управления навигацию по разделам данных во время выполнения.
AutoSort	Возвращает или задает значение, указывающее, поддерживает ли LinqDataSource элемент управления сортировку данных во время выполнения.
BindingContainer	Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control)
ChildControlsCreated	Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control)
ClientID	Возвращает идентификатор элемента управления сервера, созданный ASP.NET. (Унаследовано от DataSourceControl)
ClientIDMode	Это свойство не используется для элементов управления источниками данных. (Унаследовано от DataSourceControl)
ClientIDSeparator	Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control)
Context	HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control)
ContextTypeName	Возвращает или задает имя типа, содержащего свойство, значение которого содержит данные, которые требуется получить.
Controls	ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от DataSourceControl)
DataItemContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control)
DataKeysContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control)
DeleteParameters	Это свойство не используется классом LinqDataSource .
DesignMode	Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control)
EnableDelete	Возвращает или задает значение, указывающее, можно ли удалять записи данных с помощью LinqDataSource элемента управления.
EnableInsert	Возвращает или задает значение, указывающее, можно ли вставлять записи данных с помощью LinqDataSource элемента управления.
EnableObjectTracking	Возвращает или задает значение, указывающее, отслеживаются ли изменения объекта контекста данных.
EnableTheming	Возвращает значение, указывающее, поддерживает ли этот элемент управления темы. (Унаследовано от DataSourceControl)
EnableUpdate	Возвращает или задает значение, указывающее, можно ли обновлять записи данных с помощью LinqDataSource элемента управления.
EnableViewState	Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control)
EntitySetName	Возвращает или задает имя свойства или поля в объекте источника данных, представляющего коллекцию данных. (Унаследовано от ContextDataSource)
EntityTypeName	Возвращает или задает имя типа, созданного для операций вставки, удаления и обновления. (Унаследовано от ContextDataSource)
Events	Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
GroupBy	Возвращает или задает значение, указывающее, какие свойства используются для группировки извлеченных данных.
GroupByParameters	Возвращает коллекцию параметров, используемых для создания предложения Group By.
HasChildViewState	Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control)
ID	Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control)
InsertParameters	Возвращает коллекцию параметров, используемых во время операции вставки.
IsChildControlStateCleared	Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control)
IsTrackingViewState	Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control)
IsViewStateEnabled	Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control)
LoadViewStateByID	Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control)
NamingContainer	Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control)
OrderBy	Возвращает или задает значение, указывающее, какие поля используются для упорядочивания извлеченных данных.
OrderByParameters	Возвращает коллекцию параметров, используемых для создания предложения Order By.
OrderGroupsBy	Возвращает или задает поля, используемые для упорядочивания сгруппированных данных.
OrderGroupsByParameters	Возвращает коллекцию параметров, которые используются для создания предложения Order Groups By.
Page	Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control)
Parent	Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control)
RenderingCompatibility	Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control)
Select	Возвращает или задает свойства и вычисляемые значения, включенные в извлеченные данные.
SelectParameters	Возвращает коллекцию параметров, используемых во время операции извлечения данных.
Site	Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control)
SkinID	Получает кожу, применяемую к элементу DataSourceControl управления. (Унаследовано от DataSourceControl)
StoreOriginalValuesInViewState	Возвращает или задает значение, указывающее, должны ли данные из источника данных храниться в состоянии представления, чтобы убедиться, что данные не были изменены другим процессом перед обновлением или удалением.
TableName	Возвращает или задает имя свойства или поля в классе контекста данных, представляющего коллекцию данных.
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control)
UniqueID	Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control)
UpdateParameters	Эта коллекция не используется классом LinqDataSource .
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control)
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control)
ViewStateMode	Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control)
Visible	Возвращает или задает значение, указывающее, отображается ли элемент управления визуально. (Унаследовано от DataSourceControl)
Where	Возвращает или задает значение, указывающее, какие условия должны быть верными для записи, которая должна быть включена в извлеченные данные.
WhereParameters	Возвращает коллекцию параметров, используемых для создания предложения Where.

Методы

Имя	Описание
AddedControl(Control, Int32)	Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control)
AddParsedSubObject(Object)	Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control)
ApplyStyleSheetSkin(Page)	Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control)
BuildProfileTree(String, Boolean)	Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control)
ClearCachedClientID()	Задает кэшированное ClientID значение null. (Унаследовано от Control)
ClearChildControlState()	Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildState()	Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildViewState()	Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearEffectiveClientIDMode()	ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control)
CreateChildControls()	Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control)
CreateControlCollection()	Создает коллекцию для хранения дочерних элементов управления. (Унаследовано от DataSourceControl)
CreateQueryableView()	Возвращает запрашиваемое представление.
CreateView()	Создает новый экземпляр класса, связанного LinqDataSourceView с этим элементом управления.
DataBind()	Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control)
DataBind(Boolean)	Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control)
DataBindChildren()	Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control)
Delete(IDictionary, IDictionary)	Выполняет операцию удаления.
Dispose()	Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control)
EndRenderTracing(TextWriter, Object)	Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control)
EnsureChildControls()	Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control)
EnsureID()	Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindControl(String, Int32)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным id и целым числом, указанным в pathOffset параметре, который помогает в поиске. Эту версию FindControl метода не следует переопределять. (Унаследовано от Control)
FindControl(String)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным id параметром. (Унаследовано от DataSourceControl)
Focus()	Задает фокус ввода для элемента управления. (Унаследовано от DataSourceControl)
GetDesignModeState()	Возвращает данные во время разработки для элемента управления. (Унаследовано от Control)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRouteUrl(Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(String, Object)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetUniqueIDRelativeTo(Control)	Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control)
GetView(String)	Возвращает представление источника данных, связанное QueryableDataSource с объектом. (Унаследовано от QueryableDataSource)
GetViewNames()	Возвращает коллекцию имен, представляющих представления, связанные с элементом QueryableDataSource управления. (Унаследовано от QueryableDataSource)
HasControls()	Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от DataSourceControl)
HasEvents()	Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control)
Insert(IDictionary)	Выполняет операцию вставки.
IsLiteralContent()	Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control)
LoadControlState(Object)	Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control)
LoadViewState(Object)	Загружает состояние значений в элементе QueryableDataSource управления, которое необходимо сохранить. (Унаследовано от QueryableDataSource)
MapPathSecure(String)	Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnBubbleEvent(Object, EventArgs)	Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control)
OnDataBinding(EventArgs)	Вызывает событие DataBinding. (Унаследовано от Control)
OnInit(EventArgs)	Инициализирует объект LinqDataSource.
OnLoad(EventArgs)	Вызывает событие Load. (Унаследовано от Control)
OnPreRender(EventArgs)	Вызывает событие PreRender. (Унаследовано от Control)
OnUnload(EventArgs)	Вызывает событие Unload.
OpenFile(String)	Возвращает используемый Stream для чтения файла. (Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)	Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control)
RaiseDataSourceChangedEvent(EventArgs)	Вызывает событие DataSourceChanged. (Унаследовано от DataSourceControl)
RaiseViewChanged()	OnDataSourceViewChanged(EventArgs) Вызывает метод DataSourceView класса. (Унаследовано от QueryableDataSource)
RemovedControl(Control)	Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control)
Render(HtmlTextWriter)	Отправляет содержимое элемента управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от DataSourceControl)
ResolveAdapter()	Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control)
SaveControlState()	Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет текущее состояние QueryableDataSource представления элемента управления. (Унаследовано от QueryableDataSource)
SetDesignModeState(IDictionary)	Задает данные во время разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Отслеживает изменения QueryableDataSource состояния представления элемента управления, чтобы изменения могли храниться в объекте StateBag для элемента управления. (Унаследовано от QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления.
UpdateParameterVales()	Обновляет значения параметров, которые изменились с момента предыдущего запроса. (Унаследовано от QueryableDataSource)

События

Имя	Описание
ContextCreated	Происходит после создания экземпляра объекта типа контекста.
ContextCreating	Происходит перед созданием экземпляра объекта типа контекста.
ContextDisposing	Происходит перед удалением объекта типа контекста.
DataBinding	Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control)
Deleted	Происходит после завершения операции удаления.
Deleting	Происходит перед операцией удаления.
Disposed	Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control)
Init	Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control)
Inserted	Происходит после завершения операции вставки.
Inserting	Происходит перед операцией вставки.
Load	Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control)
PreRender	Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control)
QueryCreated	Происходит при добавлении или удалении запроса из элемента управления источниками данных. (Унаследовано от QueryableDataSource)
Selected	Происходит при завершении операции извлечения данных.
Selecting	Происходит перед операцией извлечения данных.
Unload	Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control)
Updated	Происходит после завершения операции обновления.
Updating	Происходит перед операцией обновления.

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

Имя	Описание
IControlBuilderAccessor.ControlBuilder	Описание этого элемента см. в разделе ControlBuilder. (Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()	Описание этого элемента см. в разделе GetDesignModeState(). (Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Описание этого элемента см. в разделе SetDesignModeState(IDictionary). (Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Описание этого элемента см. в разделе SetOwnerControl(Control). (Унаследовано от Control)
IControlDesignerAccessor.UserData	Описание этого элемента см. в разделе UserData. (Унаследовано от Control)
IDataBindingsAccessor.DataBindings	Описание этого элемента см. в разделе DataBindings. (Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings	Описание этого элемента см. в разделе HasDataBindings. (Унаследовано от Control)
IDataSource.DataSourceChanged	Происходит при изменении элемента управления источником данных таким образом, что влияет на элементы управления с привязкой к данным. (Унаследовано от DataSourceControl)
IDataSource.GetView(String)	Возвращает именованный DataSourceView объект, связанный с элементом DataSourceControl управления. Некоторые элементы управления источниками данных поддерживают только одно представление, а другие поддерживают несколько. (Унаследовано от DataSourceControl)
IDataSource.GetViewNames()	Возвращает коллекцию имен, представляющую список DataSourceView объектов, связанных с элементом DataSourceControl управления. (Унаследовано от DataSourceControl)
IDynamicDataSource.ContextType	Описание этого элемента см. в разделе IDynamicDataSource.
IDynamicDataSource.EntitySetName	Описание этого элемента см. в разделе IDynamicDataSource.
IDynamicDataSource.Exception	Описание этого элемента см. в разделе IDynamicDataSource.
IExpressionsAccessor.Expressions	Описание этого элемента см. в разделе Expressions. (Унаследовано от Control)
IExpressionsAccessor.HasExpressions	Описание этого элемента см. в разделе HasExpressions. (Унаследовано от Control)
IListSource.ContainsListCollection	Указывает, связан ли элемент управления источником данных с одним или несколькими списками данных. (Унаследовано от DataSourceControl)
IListSource.GetList()	Возвращает список элементов управления источниками данных, которые можно использовать в качестве источников списков данных. (Унаследовано от DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Описание этого элемента см. в разделе AddParsedSubObject(Object). (Унаследовано от Control)

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

Имя	Описание
ExpandDynamicWhereParameters(IDynamicDataSource)	Расширяет динамические фильтры в Where параметры, которые доступны источнику данных.
FindDataSourceControl(Control)	Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления.
FindFieldTemplate(Control, String)	Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления.
FindMetaTable(Control)	Возвращает объект метатабли для содержащего элемента управления данными.
GetDefaultValues(IDataSource)	Возвращает коллекцию значений по умолчанию для указанного источника данных.
GetMetaTable(IDataSource)	Возвращает метаданные таблицы в указанном объекте источника данных.
GetTable(IDynamicDataSource)	MetaTable Возвращает объект, связанный с указанным элементом управления источниками данных.
LoadWith<TEntity>(LinqDataSource)	DataLoadOptions Задает значение источника данных LINQ-to-SQL для принудительной загрузки всех сущностей внешнего ключа.
LoadWithForeignKeys(LinqDataSource, Type)	DataLoadOptions Задает значение источника данных LINQ-to-SQL для принудительной загрузки всех сущностей внешнего ключа.
TryGetMetaTable(IDataSource, MetaTable)	Определяет, доступны ли метаданные таблицы.

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

• LINQ to SQL