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 DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Наследование
- Атрибуты
Примеры
В этом разделе показана разметка 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определяет объект данных, возвращаемый методомGetAllEmployeesEmployeeLogicкласса.
Дополнительный 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 свойство, не поддерживаются.
Purpose
Очень распространенная практика проектирования приложений заключается в том, чтобы разделить уровень презентации от бизнес-логики и инкапсулировать бизнес-логику в бизнес-объектах. Эти бизнес-объекты образуют отдельный слой между уровнем презентации и уровнем данных, что приводит к архитектуре трехуровневого приложения. Этот ObjectDataSource элемент управления позволяет разработчикам использовать ASP.NET управление версиями данных при сохранении архитектуры трехуровневых приложений.
Элемент ObjectDataSource управления использует отражение для создания экземпляров бизнес-объектов и вызова методов для получения, обновления, вставки и удаления данных. Свойство TypeName определяет имя класса, с которым работает этот ObjectDataSource класс. Элемент управления создает и уничтожает экземпляр класса для каждого вызова метода. Он ObjectDataSource не содержит объект в памяти для времени существования веб-запроса. Это серьезное внимание, если бизнес-объект, используемый вами, требует большого количества ресурсов или в противном случае является дорогостоящим для создания и уничтожения. Использование дорогостоящего объекта может не быть оптимальным вариантом проектирования, но вы можете управлять жизненным циклом объекта с помощью ObjectCreatingи ObjectCreatedсобытий, а также ObjectDisposing событий.
Замечание
Методы, определяемые методом SelectMethod, UpdateMethodInsertMethodи DeleteMethod свойствами, могут быть методами экземпляра илиSharedstatic (в Visual Basic). Если методы находятся static (Sharedв Visual Basic), экземпляр бизнес-объекта не создается, а ObjectDisposingObjectCreatingObjectCreatedсобытия не создаются.
Получение данных
Чтобы получить данные из бизнес-объекта, задайте 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 объект), так как один и тот же экземпляр объекта будет использоваться для обслуживания нескольких запросов.
Features
В следующей ObjectDataSource таблице описываются функции элемента управления.
| Функциональность | Требования |
|---|---|
| Выбор | SelectMethod Присвойте свойству имя метода бизнес-объекта, который выбирает данные, и включите все необходимые параметры в SelectParameters коллекцию программным способом или с помощью элемента управления с привязкой к данным. |
| Сортировка | SortParameterName Задайте для свойства имя параметра в методеSelectMethod, который несет критерии сортировки. |
| Фильтрация | Задайте свойству FilterExpression выражение фильтрации и при необходимости добавьте все параметры в FilterParameters коллекцию, чтобы отфильтровать данные при вызове Select метода. Метод, указанный свойством SelectMethod , должен возвращать DataSet или DataTable. |
| Paging | Поддерживается разбиение по страницам источника данных, если SelectMethod метод содержит параметры максимального количества записей для извлечения и индекса первой записи для получения. Имена этих параметров должны быть заданы в MaximumRowsParameterName и StartRowIndexParameterName свойствах соответственно. Элемент управления с привязкой к данным может выполнять разбиение по страницам, даже если ObjectDataSource элемент управления не поддерживает разбиение по страницам непосредственно в методе, указанном свойством SelectMethod . Требование для элемента управления, привязанного к данным, заключается в том, что метод, заданный SelectMethod свойством, возвращает объект, реализующий ICollection интерфейс. |
| Обновление | UpdateMethod Задайте для свойства имя метода бизнес-объекта, который обновляет данные и включает в коллекцию все необходимые UpdateParameters параметры. |
| Удаление | DeleteMethod Задайте для свойства имя метода или функции бизнес-объекта, которая удаляет данные, и включите в коллекцию все необходимые DeleteParameters параметры. |
| Вставка | InsertMethod Задайте свойству имя метода или функции бизнес-объекта, которая вставляет данные и включает все необходимые параметры в коллекциюInsertParameters. |
| Кэширование |
EnableCaching Задайте для свойства trueзначение и CacheDurationCacheExpirationPolicy свойства в соответствии с поведением кэширования, которое требуется для кэшированных данных. |
Замечание
При использовании ObjectDataSource класса для обновления или вставки данных строки, введенные на клиенте, не автоматически преобразуются из формата языка и региональных параметров клиента в формат языка и региональных параметров сервера. Например, язык и региональные параметры клиента могут указывать DD/MM/ГГГГ в качестве формата даты, а формат даты на сервере может быть MM/DD/ГГГГ. В этом случае 5 октября 2009 г. будет введен в TextBox контроль как 5/10/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 для свойства имя класса контекста данных. Вы также задаете SelectMethodUpdateMethodInsertMethodметоды и DeleteMethod методы в классе контекста данных, выполняющие соответствующие операции. Чтобы отменить удаление класса контекста данных, необходимо создать обработчик событий для 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 |
Возвращает или задает значение, определяющее, передаются |
| Context |
HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от DataSourceControl) |
| ConvertNullToDBNull |
Возвращает или задает значение, указывающее, преобразуются ли Parameter значения, передаваемые в операцию обновления, вставки или удаления, автоматически преобразуются в |
| 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 |
Возвращает или задает строку формата, которая применяется к именам параметров для исходных значений, передаваемых |
| 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) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает кэшированное ClientID значение |
| 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, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| 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) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отправляет содержимое элемента управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от DataSourceControl) |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет состояние ObjectDataSource элемента управления. |
| Select() |
Извлекает данные из базового хранилища данных, вызывая метод, который определяется SelectMethod свойством с параметрами SelectParameters в коллекции. |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(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) |
Определяет, доступны ли метаданные таблицы. |
Применяется к
См. также раздел
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Пошаговое руководство. Привязка данных к пользовательскому бизнес-объекту
- Элементы управления веб-сервером источника данных
- Обзор элемента управления ObjectDataSource
- Создание объекта источника элемента управления ObjectDataSource
- Использование Entity Framework и элемента управления ObjectDataSource
