ObjectDataSource Класс

Определение

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

public ref class ObjectDataSource : System::Web::UI::DataSourceControl
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
    inherit DataSourceControl
Public Class ObjectDataSource
Inherits DataSourceControl
Наследование
ObjectDataSource
Атрибуты

Примеры

В этом разделе отображается разметка ObjectDataSource в aspx-странице, а также бизнес-объекты, с которыми она работает. Примером является aspx-страница. Он содержит GridView элемент управления, привязанный к элементу ObjectDataSource управления . Разметка ObjectDataSource элемента управления указывает имя бизнес-объекта и имя метода бизнес-объекта, вызываемого для получения данных.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </form>
  </body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

    </form>
  </body>
</html>

В следующем примере показан бизнес-объект, который ObjectDataSource использует элемент управления на aspx-странице. (Во многих других ObjectDataSource примерах кода также используется этот бизнес-объект.) Пример состоит из следующих двух основных классов:

  • Класс EmployeeLogic — это класс бизнес-логики, который использует .ObjectDataSource

  • Класс NorthwindEmployee определяет объект данных, возвращаемый GetAllEmployees методом EmployeeLogic класса .

В качестве удобства предоставляется дополнительный NorthwindDataException класс.

Этот набор примеров классов работает с базой данных Northwind Traders, доступной в Microsoft SQL Server и Microsoft Access. Для полного рабочего примера необходимо скомпилировать и использовать эти классы с предоставленным примером страницы ASPX.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates
  // the operations one can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

      SqlDataSource sds
        = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

      try {

        IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

        // Iterate through the Enumeration and create a
        // NorthwindEmployee object for each ID.
        foreach (DataRowView row in IDs) {
          string id = row["EmployeeID"].ToString();
          NorthwindEmployee nwe = new NorthwindEmployee(id);
          // Add the NorthwindEmployee object to the collection.
          al.Add(nwe);
        }
      }
      finally {
        // If anything strange happens, clean up.
        sds.Dispose();
      }

      return al;
    }
    public static NorthwindEmployee GetEmployee(object anID) {
      return new NorthwindEmployee(anID);
    }

    public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
      bool retval = ne.Save();
      if (! retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
    }

    public static void DeleteEmployee(NorthwindEmployee ne) { }
  }

  public class NorthwindEmployee {

    public NorthwindEmployee () {
      ID = DBNull.Value;
      lastName = "";
      firstName = "";
      title="";
      titleOfCourtesy = "";
      reportsTo = -1;
    }

    public NorthwindEmployee (object anID) {
      this.ID = anID;

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

        SqlConnection conn = new SqlConnection (cts.ConnectionString);
      SqlCommand sc =
        new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
                       " FROM Employees " +
                       " WHERE EmployeeID = @empId",
                       conn);
      // Add the employee ID parameter and set its value.
      sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
      SqlDataReader sdr = null;

      try {
        conn.Open();
        sdr = sc.ExecuteReader();

        // This is not a while loop. It only loops once.
        if (sdr != null && sdr.Read()) {
          // The IEnumerable contains DataRowView objects.
          this.firstName        = sdr["FirstName"].ToString();
          this.lastName         = sdr["LastName"].ToString();
          this.title            = sdr["Title"].ToString();
          this.titleOfCourtesy  = sdr["TitleOfCourtesy"].ToString();
          if (! sdr.IsDBNull(4)) {
            this.reportsTo        = sdr.GetInt32(4);
          }
        }
        else {
          throw new NorthwindDataException("Data not loaded for employee id.");
        }
      }
      finally {
        try {
          if (sdr != null) sdr.Close();
          conn.Close();
        }
        catch (SqlException) {
          // Log an event in the Application Event Log.
          throw;
        }
      }
    }

    private object ID;

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    private string title;
    public String Title {
      get { return title; }
      set { title = value; }
    }

    private string titleOfCourtesy;
    public string Courtesy {
      get { return titleOfCourtesy; }
      set { titleOfCourtesy = value; }
    }

    private int    reportsTo;
    public int Supervisor {
      get { return reportsTo; }
      set { reportsTo = value; }
    }

    public bool Save () {
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}
Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
   ' Returns a collection of NorthwindEmployee objects.
   Public Shared Function GetAllEmployees() As ICollection
      Dim al As New ArrayList()

      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
      Try
         Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

         ' Iterate through the Enumeration and create a
         ' NorthwindEmployee object for each ID.
         For Each row As DataRowView In IDs
            Dim id As String = row("EmployeeID").ToString()
            Dim nwe As New NorthwindEmployee(id)
            ' Add the NorthwindEmployee object to the collection.
            al.Add(nwe)
         Next
      Finally
         ' If anything strange happens, clean up.
         sds.Dispose()
      End Try

      Return al
   End Function 'GetAllEmployees

   Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
      Return New NorthwindEmployee(anID)
   End Function 'GetEmployee


   Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
      Dim retval As Boolean = ne.Save()
      If Not retval Then
         Throw New NorthwindDataException("UpdateEmployee failed.")
      End If
   End Sub

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub

End Class


Public Class NorthwindEmployee


   Public Sub New()
      ID = DBNull.Value
      aLastName = ""
      aFirstName = ""
      aTitle = ""
      titleOfCourtesy = ""
      reportsTo = - 1
   End Sub


   Public Sub New(anID As Object)
      Me.ID = anID
      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim conn As New SqlConnection(cts.ConnectionString)
      Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
                               " FROM Employees " & _
                               " WHERE EmployeeID = @empId", conn)
      ' Add the employee ID parameter and set its value.
      sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
      Dim sdr As SqlDataReader = Nothing

      Try
         conn.Open()
         sdr = sc.ExecuteReader()

         ' This is not a while loop. It only loops once.
         If Not (sdr Is Nothing) AndAlso sdr.Read() Then
            ' The IEnumerable contains DataRowView objects.
            Me.aFirstName = sdr("FirstName").ToString()
            Me.aLastName = sdr("LastName").ToString()
            Me.aTitle = sdr("Title").ToString()
            Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
            If Not sdr.IsDBNull(4) Then
               Me.reportsTo = sdr.GetInt32(4)
            End If
         Else
            Throw New NorthwindDataException("Data not loaded for employee id.")
         End If
      Finally
         Try
            If Not (sdr Is Nothing) Then
               sdr.Close()
            End If
            conn.Close()
         Catch se As SqlException
            ' Log an event in the Application Event Log.
            Throw
         End Try
      End Try
   End Sub

   Private ID As Object

   Private aLastName As String
   Public Property LastName() As String
      Get
         Return aLastName
      End Get
      Set
         aLastName = value
      End Set
   End Property

   Private aFirstName As String
   Public Property FirstName() As String
      Get
         Return aFirstName
      End Get
      Set
         aFirstName = value
      End Set
   End Property

   Private aTitle As String
   Public Property Title() As String
      Get
         Return aTitle
      End Get
      Set
         aTitle = value
      End Set
   End Property

   Private titleOfCourtesy As String
   Public Property Courtesy() As String
      Get
         Return titleOfCourtesy
      End Get
      Set
         titleOfCourtesy = value
      End Set
   End Property
   Private reportsTo As Integer

   Public Property Supervisor() As Integer
      Get
         Return reportsTo
      End Get
      Set
         reportsTo = value
      End Set
   End Property

   Public Function Save() As Boolean
      Return True
   End Function 'Save
End Class


Friend Class NorthwindDataException
   Inherits Exception

   Public Sub New(msg As String)
      MyBase.New(msg)
   End Sub
End Class
End Namespace

Комментарии

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

Вступление

Элемент ObjectDataSource управления работает с создаваемым классом. Вы создаете методы, которые извлекают и обновляют данные, и предоставляете имена этих методов элементу ObjectDataSource управления в разметке. Во время отрисовки или обратной ObjectDataSource обработки вызывает указанные методы.

Визуальный отрисовка ObjectDataSource элемента управления отсутствует. В результате объект не поддерживает визуальные функции, ObjectDataSource такие как EnableTheming свойство или SkinID .

Назначение

Очень распространенная практика проектирования приложений заключается в том, чтобы отделить уровень представления от бизнес-логики и инкапсулировать бизнес-логику в бизнес-объектах. Эти бизнес-объекты образуют отдельный слой между уровнем представления и уровнем данных, что приводит к трехуровневой архитектуре приложения. Элемент ObjectDataSource управления позволяет разработчикам использовать ASP.NET управления источником данных, сохраняя при этом трехуровневую архитектуру приложения.

Элемент ObjectDataSource управления использует отражение для создания экземпляров бизнес-объектов и вызова методов для их извлечения, обновления, вставки и удаления данных. Свойство TypeName определяет имя класса, с которым ObjectDataSource работает . Элемент ObjectDataSource управления создает и уничтожает экземпляр класса для каждого вызова метода; он не хранит объект в памяти в течение времени существования веб-запроса. Это серьезное соображение, если используемый бизнес-объект требует большого количества ресурсов или является дорогостоящим для создания и уничтожения. Использование дорогостоящего объекта может быть не оптимальным вариантом проектирования, но вы можете управлять жизненным циклом объекта с помощью ObjectCreatingсобытий , ObjectCreatedи ObjectDisposing .

Примечание

Методы, определяемые свойствами SelectMethod, UpdateMethod, InsertMethodи DeleteMethod , могут быть методами экземпляра или static (Shared в Visual Basic). Если методы имеют значение static (Shared в Visual Basic), экземпляр бизнес-объекта не создается, а ObjectCreatingсобытия , ObjectCreatedи ObjectDisposing не создаются.

Извлечение данных

Чтобы получить данные из бизнес-объекта, присвойте свойству SelectMethod имя метода, извлекающего данные. Если метод не возвращает IEnumerable объект или DataSet , объект упаковывается средой выполнения в коллекцию IEnumerable . Если сигнатура метода имеет параметры, можно добавить Parameter объекты в SelectParameters коллекцию, а затем привязать их к значениям, которые необходимо передать методу, указанному свойством SelectMethod . Чтобы ObjectDataSource элемент управления использовал параметры, параметры должны соответствовать именам и типам параметров в сигнатуре метода. Дополнительные сведения см. в разделе Использование параметров с элементом управления ObjectDataSource.

Элемент ObjectDataSource управления извлекает данные при каждом вызове Select метода . Этот метод предоставляет программный доступ к методу, заданному свойством SelectMethod . Метод, заданный свойством SelectMethod , вызывается автоматически элементами управления, привязанными к при вызове ObjectDataSource метода DataBind . Если задать DataSourceID свойство элемента управления с привязкой к данным, элемент управления автоматически привязывается к данным из источника данных по мере необходимости. DataSourceID Настройка свойства является рекомендуемым методом привязки ObjectDataSource элемента управления к элементу управления с привязкой к данным. Кроме того, можно задать DataSource свойство , но затем необходимо явно вызвать DataBind метод элемента управления с привязкой к данным. Метод можно вызвать программным способом Select в любое время для получения данных.

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

Выполнение операций с данными

В зависимости от возможностей бизнес-объекта, с которым ObjectDataSource работает элемент управления, можно выполнять операции с данными, такие как обновления, вставки и удаления. Чтобы выполнить эти операции с данными, задайте соответствующее имя метода и все связанные параметры для операции, которую вы хотите выполнить. Например, для операции обновления задайте UpdateMethod для свойства имя метода бизнес-объекта, выполняющего обновления, и добавьте все необходимые параметры в коллекцию UpdateParameters . ObjectDataSource Если элемент управления связан с элементом управления с привязкой к данным, параметры добавляются элементом управления с привязкой к данным. В этом случае необходимо убедиться, что имена параметров метода совпадают с именами полей в элементе управления с привязкой к данным. Обновление выполняется при вызове Update метода явным образом в коде или автоматически с помощью элемента управления с привязкой к данным. Для операций и Insert используется Delete тот же общий шаблон. Предполагается, что бизнес-объекты выполняют эти типы операций с данными по одной записи за раз, а не пакетной обработки.

Фильтрация данных

Элемент ObjectDataSource управления может фильтровать данные, полученные свойством SelectMethod , если данные возвращаются в виде DataSet объекта или DataTable . Для свойства можно задать FilterExpression фильтрующее выражение с помощью синтаксиса строки формата и привязать значения в выражении к параметрам, указанным в FilterParameters коллекции.

Кэширование

ObjectDataSource Хотя не сохраняет экземпляр бизнес-объекта в нескольких запросах, он может кэшировать результат вызова метода, определяемого свойством SelectMethod . Пока данные кэшируются, последующие вызовы Select метода возвращают кэшированные данные вместо создания бизнес-объекта и вызова его SelectMethod с помощью отражения. Кэширование позволяет избежать создания объекта и вызова его метода данных за счет памяти на веб-сервере. Автоматически ObjectDataSource кэширует данные, если свойству EnableCaching присвоено значение true, а свойству CacheDuration присваивается количество секунд, в течение которых кэш хранит данные до того, как кэш будет удален. Можно также указать CacheExpirationPolicy свойство и необязательное SqlCacheDependency свойство. Элемент ObjectDataSource управления позволяет кэшировать все типы данных, но не следует кэшировать объекты, сохраняющие ресурсы или состояние, которые нельзя совместно использовать для обслуживания нескольких запросов (например, открытого SqlDataReader объекта), так как один и тот же экземпляр объекта будет использоваться для обслуживания нескольких запросов.

Компоненты

В следующей таблице описаны функции ObjectDataSource элемента управления .

Функция Требования
Выбрать Присвойте свойству SelectMethod имя метода бизнес-объекта, который выбирает данные, и включите все необходимые параметры в SelectParameters коллекцию программным способом или с помощью элемента управления с привязкой к данным.
Сортировка Присвойте SortParameterName свойству имя параметра в методе SelectMethod , который содержит условия сортировки.
Фильтрация Присвойте свойству FilterExpression фильтрующее выражение и при необходимости добавьте все параметры в FilterParameters коллекцию, чтобы отфильтровать данные при вызове Select метода . Метод, заданный свойством , SelectMethod должен возвращать DataSet или DataTable.
Разбивка на страницы Подкачки источника данных поддерживаются, если SelectMethod метод содержит параметры для максимального количества извлекаемых записей и индекса первой извлекаемой записи. Имена этих параметров должны быть заданы в свойствах MaximumRowsParameterName и StartRowIndexParameterName соответственно. Элемент управления с привязкой к данным может выполнять разбиение по страницам, даже если ObjectDataSource он не поддерживает разбиение по страницам непосредственно в методе, указанном свойством SelectMethod . Чтобы элемент управления с привязкой к данным мог это сделать, требуется, чтобы метод, заданный свойством SelectMethod , возвращал объект, реализующий ICollection интерфейс .
Обновление Присвойте свойству UpdateMethod имя метода бизнес-объекта, который обновляет данные, и включите все необходимые параметры в коллекцию UpdateParameters .
Удаление Присвойте свойству DeleteMethod имя метода или функции бизнес-объекта, которая удаляет данные, и включите все необходимые параметры в коллекцию DeleteParameters .
Вставка Присвойте свойству InsertMethod имя метода или функции бизнес-объекта, которая вставляет данные, и включите все необходимые параметры в коллекцию InsertParameters .
Кэширование Задайте для EnableCaching свойства trueзначение , а CacheDuration свойства и в CacheExpirationPolicy соответствии с поведением кэширования кэшированных данных.

Примечание

При использовании ObjectDataSource класса для обновления или вставки данных строки, введенные на клиенте, не преобразуются автоматически из клиентского формата языка и региональных параметров в формат сервера. Например, язык и региональные параметры клиента могут указывать ДД/ММ/ГГГГ в качестве формата даты, а формат даты на сервере может быть ММ/ДД/ГГГГ. В этом случае 5 октября 2009 года будет введен в TextBox элемент управления как 10.05.2009, но будет интерпретироваться как 10 мая 2009 года. 15 октября 2009 года будет введено как 15/10/2009, и будет отклонено как недопустимая дата.

Представление данных

Как и все элементы управления источником данных, элемент ObjectDataSource управления связан с классом представления источника данных. ObjectDataSource Хотя элемент управления является интерфейсом, который разработчик страницы использует для работы с даннымиObjectDataSourceView, класс — это интерфейс, с которым работают элементы управления с привязкой к данным. Кроме того, ObjectDataSourceView класс описывает возможности элемента управления источником данных и выполняет фактическую работу. Элемент ObjectDataSource управления имеет только один связанный ObjectDataSourceViewэлемент управления и всегда называется DefaultView. ObjectDataSourceView Хотя объект предоставляется методом GetView , многие его свойства и методы упаковываются и предоставляются непосредственно элементом ObjectDataSource управления . В фоновом режиме ObjectDataSourceView объект выполняет все операции с данными, включая извлечение, вставку, обновление, удаление, фильтрацию и сортировку данных. Для получения дополнительной информации см. ObjectDataSourceView.

Использование LINQ to SQL

Элемент управления можно использовать ObjectDataSource с классом LINQ to SQL. Для этого присвойте свойству TypeName имя класса контекста данных. Методы , UpdateMethod, InsertMethodи DeleteMethod также задаются SelectMethodдля методов в классе контекста данных, которые выполняют соответствующие операции. Чтобы отменить удаление класса контекста данных, необходимо создать обработчик ObjectDisposing события. Этот шаг необходим, так как LINQ to SQL поддерживает отложенное выполнение, а ObjectDataSource элемент управления пытается удалить контекст данных после операции Select. Дополнительные сведения о создании классов LINQ to SQL см. в разделе Практическое руководство. Создание классов LINQ to SQL в веб-проекте. Пример отмены удаления класса контекста данных см. в этом событии ObjectDisposing .

Использование Entity Framework

Элемент управления можно также использовать ObjectDataSource с Entity Framework. Дополнительные сведения см. в разделе Использование Entity Framework и элемента управления ObjectDataSource.

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

<asp:ObjectDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConvertNullToDBNull="True|False"
    DataObjectTypeName="string"
    DeleteMethod="string"
    EnableCaching="True|False"
    EnablePaging="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertMethod="string"
    MaximumRowsParameterName="string"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnObjectCreated="ObjectCreated event handler"
    OnObjectCreating="ObjectCreating event handler"
    OnObjectDisposing="ObjectDisposing 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"
    runat="server"
    SelectCountMethod="string"
    SelectMethod="string"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    StartRowIndexParameterName="string"
    TypeName="string"
    UpdateMethod="string"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:ObjectDataSource>

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

ObjectDataSource()

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

ObjectDataSource(String, String)

Инициализирует новый экземпляр класса ObjectDataSource с заданными именем типа и именем метода извлечения данных.

Свойства

Adapter

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

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

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.

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

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

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

Возвращает или задает длину промежутка времени (в секундах), в течение которого элемент управления источником данных кэширует данные, полученные с помощью свойства SelectMethod.

CacheExpirationPolicy

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

CacheKeyDependency

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

ChildControlsCreated

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

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

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

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

Это свойство не используется для элементов управления источником данных.

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

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

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

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

Context

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

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

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

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

Возвращает или задает значение, позволяющее определить, выполняет ли элемент управления Parameter автоматическое преобразование значений Value, переданных операции обновления, вставки или удаления и равных величине null, в значение ObjectDataSource.

DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer.

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

Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl.

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

Возвращает или задает имя класса, используемое элементом управления ObjectDataSource в качестве параметра в операции обновления, вставки или удаления данных вместо передачи отдельных значений из элемента управления с привязкой к данным.

DeleteMethod

Возвращает или задает имя метода или функции, вызываемого элемента управления ObjectDataSource для удаления данных.

DeleteParameters

Получает коллекцию параметров, содержащую параметры, используемые методом DeleteMethod.

DesignMode

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

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

Возвращает или задает значение позволяющее определить, включено ли кэширование для элемента управления ObjectDataSource.

EnablePaging

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

EnableTheming

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

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

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

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

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

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

Возвращает или задает выражение фильтрации, применяемое при вызове метода, заданного свойством SelectMethod.

FilterParameters

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

HasChildViewState

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

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

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

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

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

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

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

InsertParameters

Получает коллекцию параметров, содержащую параметры, используемые свойством InsertMethod.

IsChildControlStateCleared

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

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

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

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

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

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

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

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

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

NamingContainer

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

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

Получает или задает строку формата, применяемую к именам параметров для исходных значений, передаваемых методу Delete или Update.

Page

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

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

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

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

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

RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.

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

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

SelectMethod

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

SelectParameters

Получает коллекцию параметров, используемых методом, заданным свойством SelectMethod.

Site

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

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

Возвращает обложку для применения к элементу управления DataSourceControl.

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

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

SqlCacheDependency

Возвращает или задает разделенную точками с запятой строку, которая показывает, какие базы данных и таблицы используются для зависимости кэша Microsoft SQL Server.

StartRowIndexParameterName

Возвращает или задает имя параметра метода извлечения данных, который позволяет задать значение идентификатора первой записи для обеспечения поддержки разбиения по страницам источника данных.

TemplateControl

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

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

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

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

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

UniqueID

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

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

Возвращает или задает имя метода или функции, вызываемого элемента управления ObjectDataSource для обновления данных.

UpdateParameters

Получает коллекцию параметров, содержащую параметры, используемые методом, заданным свойством UpdateMethod.

ValidateRequestMode

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

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

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

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

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

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

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

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

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

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

Методы

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)
DataBind()

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

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

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

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

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

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

Выполняет операцию удаления путем вызова метода, заданного свойством DeleteMethod с параметрами, содержащимися в коллекции DeleteParameters.

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)

Извлекает именованное представление источника данных, связанное с элементом управления источника данных.

GetViewNames()

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

HasControls()

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

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

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

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

Выполняет операцию вставки путем вызова метода, который определяется свойством InsertMethod и всеми параметрами в коллекции InsertParameters.

IsLiteralContent()

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

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

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

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

Загружает предварительно сохраненное состояние представления элемента управления ObjectDataSource.

MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).

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

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.

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

Вызывает событие DataBinding.

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

Добавляет обработчик событий LoadComplete на страницу, содержащую элемент управления ObjectDataSource.

OnLoad(EventArgs)

Вызывает событие Load.

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

Вызывает событие PreRender.

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

Вызывает событие Unload.

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

Возвращает Stream, используемое для чтения файла.

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

Присваивает родительскому элементу управления все источники события и сведения о них.

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

Вызывает событие DataSourceChanged.

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

Сохраняет состояние элемента управления ObjectDataSource.

Select()

Извлекает данные из базового хранилища данных, вызвав метод, указанный в свойстве SelectMethod, с параметрами, заданными в коллекции SelectParameters.

SetDesignModeState(IDictionary)

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

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

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

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

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

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

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

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

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

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

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

Update()

Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, и параметры, содержащиеся в коллекции UpdateParameters.

События

DataBinding

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

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

Происходит при завершении операции Delete().

Deleting

Происходит перед операцией Delete().

Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.

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

Происходит перед операцией фильтрации.

Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.

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

Происходит при завершении Insert().

Inserting

Происходит перед операцией Insert().

Load

Происходит при загрузке серверного элемента управления в объект Page.

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

Происходит после создания объекта, созданного свойством TypeName.

ObjectCreating

Происходит перед созданием объекта, созданного свойством TypeName.

ObjectDisposing

Происходит перед объявлением объекта, созданного свойством TypeName.

PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.

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

Происходит при завершении операции Select().

Selecting

Происходит перед операцией Select().

Unload

Происходит при выгрузке серверного элемента управления из памяти.

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

Происходит при завершении Update().

Updating

Происходит перед операцией Update().

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

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)
IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.

(Унаследовано от Control)
IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.

(Унаследовано от Control)
IListSource.ContainsListCollection

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

(Унаследовано от DataSourceControl)
IListSource.GetList()

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

(Унаследовано от DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).

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

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

FindDataSourceControl(Control)

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

FindFieldTemplate(Control, String)

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

FindMetaTable(Control)

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

GetDefaultValues(IDataSource)

Получает коллекцию значений по умолчанию для заданного источника данных.

GetMetaTable(IDataSource)

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

TryGetMetaTable(IDataSource, MetaTable)

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

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

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