LinqDataSource Класс

Определение

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

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
Наследование
Наследование
Атрибуты
Реализации

Примеры

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

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

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

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

  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 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 события. В обработчике событий вы вызываете метод в классе контекста данных, который представляет хранимую процедуру, и присваивает результат Result свойству LinqDataSourceSelectEventArgs объекта. Если необходимо включить автоматические операции обновления, вставки и удаления данных, тип, возвращаемый методом, должен соответствовать типу, указанному в TableName свойстве. Дополнительные сведения о создании методов контекста данных см. в разделе инструкции. Создание методов DataContext, сопоставленных с хранимыми процедурами и функциями (реляционный конструктор операций и т. д.).

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

<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

Возвращает или задает значение, которое указывает, что условия должны иметь значение true, чтобы запись могла включаться в извлеченные данные.

WhereParameters

Возвращает коллекцию параметров, которые используются для создания оператора Where.

Методы

AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.

(Унаследовано от 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)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

(Унаследовано от DataSourceControl)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

(Унаследовано от Control)
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)

Возвращает представление источника данных, связанное с объектом LinqDataSource.

GetView(String)

Получает представление источника данных, связанное с объектом QueryableDataSource.

(Унаследовано от QueryableDataSource)
GetViewNames()

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

GetViewNames()

Получает коллекцию имен, соответствующих представлениям, связанным с элементом управления QueryableDataSource.

(Унаследовано от QueryableDataSource)
HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.

(Унаследовано от DataSourceControl)
HasEvents()

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

(Унаследовано от Control)
Insert(IDictionary)

Выполняет операцию вставки.

IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.

(Унаследовано от Control)
LoadControlState(Object)

Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState().

(Унаследовано от Control)
LoadViewState(Object)

Загружает в элемент управления LinqDataSource состояние значений, которые необходимо сохранить.

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)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.

(Унаследовано от Control)
Render(HtmlTextWriter)

Отправляет содержимое серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает содержимое для отрисовки в клиенте.

(Унаследовано от Control)
RenderChildren(HtmlTextWriter)

Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте.

(Унаследовано от Control)
RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.

(Унаследовано от DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.

(Унаследовано от Control)
ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.

(Унаследовано от Control)
ResolveClientUrl(String)

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

(Унаследовано от Control)
ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.

(Унаследовано от Control)
SaveControlState()

Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер.

(Унаследовано от Control)
SaveViewState()

Сохраняет текущее состояние представления элемента управления LinqDataSource.

SaveViewState()

Сохраняет текущее состояние представления элемента управления QueryableDataSource.

(Унаследовано от QueryableDataSource)
SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления.

(Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.

(Унаследовано от Control)
SetTraceData(Object, Object)

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

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.

(Унаследовано от Control)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
TrackViewState()

Отслеживает изменения состояния представления элемента управления LinqDataSource для сохранения их в объекте StateBag этого элемента управления.

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)

Определяет, доступны ли метаданные таблицы.

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

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