Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Класс ObjectDataSource

 

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

Пространство имен:   System.Web.UI.WebControls
Сборка:  System.Web (в System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.DataSourceControl
      System.Web.UI.WebControls.ObjectDataSource

[ToolboxBitmapAttribute(typeof(ObjectDataSource))]
public class ObjectDataSource : DataSourceControl

ИмяОписание
System_CAPS_pubmethodObjectDataSource()

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

System_CAPS_pubmethodObjectDataSource(String, String)

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

ИмяОписание
System_CAPS_protpropertyAdapter

Возвращает адаптер браузера для элемента управления.(Наследуется от Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

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

System_CAPS_pubpropertyBindingContainer

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Возвращает элемент управления, содержащий привязку данных элемента управления.(Наследуется от Control.)

System_CAPS_pubpropertyCacheDuration

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

System_CAPS_pubpropertyCacheExpirationPolicy

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

System_CAPS_pubpropertyCacheKeyDependency

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

System_CAPS_protpropertyChildControlsCreated

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

System_CAPS_pubpropertyClientID

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

System_CAPS_pubpropertyClientIDMode

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

System_CAPS_protpropertyClientIDSeparator

Возвращает символьное значение, представляющее разделитель, используемый в ClientID свойство.(Наследуется от Control.)

System_CAPS_pubpropertyConflictDetection

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

System_CAPS_protpropertyContext

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

System_CAPS_pubpropertyControls

Возвращает ControlCollection представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса.(Наследуется от DataSourceControl.)

System_CAPS_pubpropertyConvertNullToDBNull

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

System_CAPS_pubpropertyDataItemContainer

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

System_CAPS_pubpropertyDataKeysContainer

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

System_CAPS_pubpropertyDataObjectTypeName

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

System_CAPS_pubpropertyDeleteMethod

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

System_CAPS_pubpropertyDeleteParameters

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

System_CAPS_protpropertyDesignMode

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

System_CAPS_pubpropertyEnableCaching

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

System_CAPS_pubpropertyEnablePaging

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

System_CAPS_pubpropertyEnableTheming

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

System_CAPS_pubpropertyEnableViewState

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

System_CAPS_protpropertyEvents

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

System_CAPS_pubpropertyFilterExpression

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

System_CAPS_pubpropertyFilterParameters

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

System_CAPS_protpropertyHasChildViewState

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

System_CAPS_pubpropertyID

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

System_CAPS_protpropertyIdSeparator

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Возвращает символ, используемый для разделения идентификаторов элементов управления.(Наследуется от Control.)

System_CAPS_pubpropertyInsertMethod

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

System_CAPS_pubpropertyInsertParameters

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

System_CAPS_protpropertyIsChildControlStateCleared

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

System_CAPS_protpropertyIsTrackingViewState

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

System_CAPS_protpropertyIsViewStateEnabled

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

System_CAPS_protpropertyLoadViewStateByID

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

System_CAPS_pubpropertyMaximumRowsParameterName

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

System_CAPS_pubpropertyNamingContainer

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

System_CAPS_pubpropertyOldValuesParameterFormatString

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

System_CAPS_pubpropertyPage

Получает ссылку на Page экземпляр, содержащий серверный элемент управления.(Наследуется от Control.)

System_CAPS_pubpropertyParent

Получает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.(Наследуется от Control.)

System_CAPS_pubpropertyParsingCulture

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

System_CAPS_pubpropertyRenderingCompatibility

Возвращает значение, которое указывает, что версия ASP.NET, созданный HTML будут совместимы с.(Наследуется от Control.)

System_CAPS_pubpropertySelectCountMethod

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

System_CAPS_pubpropertySelectMethod

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

System_CAPS_pubpropertySelectParameters

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

System_CAPS_pubpropertySite

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

System_CAPS_pubpropertySkinID

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

System_CAPS_pubpropertySortParameterName

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

System_CAPS_pubpropertySqlCacheDependency

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

System_CAPS_pubpropertyStartRowIndexParameterName

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

System_CAPS_pubpropertyTemplateControl

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

System_CAPS_pubpropertyTemplateSourceDirectory

Получает виртуальный каталог Page или UserControl содержащий текущий элемент управления сервера.(Наследуется от Control.)

System_CAPS_pubpropertyTypeName

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

System_CAPS_pubpropertyUniqueID

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

System_CAPS_pubpropertyUpdateMethod

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

System_CAPS_pubpropertyUpdateParameters

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

System_CAPS_pubpropertyValidateRequestMode

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

System_CAPS_protpropertyViewState

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

System_CAPS_protpropertyViewStateIgnoresCase

Возвращает значение, указывающее, является ли StateBag объекта без учета регистра.(Наследуется от Control.)

System_CAPS_pubpropertyViewStateMode

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

System_CAPS_pubpropertyVisible

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

ИмяОписание
System_CAPS_protmethodAddedControl(Control, Int32)

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

System_CAPS_protmethodAddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в объект ControlCollection серверного элемента управления.(Наследуется от Control.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.(Наследуется от DataSourceControl.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Начинает во время разработки трассировки визуализации данных.(Наследуется от Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Собирает сведения о серверном элементе управления и доставляет их в Trace свойству отображаться, когда трассировка включена для страницы.(Наследуется от Control.)

System_CAPS_protmethodClearCachedClientID()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Задает кэшированное ClientID значение null.(Наследуется от Control.)

System_CAPS_protmethodClearChildControlState()

Удаляет сведения о состоянии элемента управления для серверного элемента управления дочерних элементов управления.(Наследуется от Control.)

System_CAPS_protmethodClearChildState()

Удаляет сведения о состоянии представления и состояние элемента управления для всех серверного элемента управления дочерних элементов управления.(Наследуется от Control.)

System_CAPS_protmethodClearChildViewState()

Удаляет сведения о состоянии представления для всех серверного элемента управления дочерних элементов управления.(Наследуется от Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Наборы ClientIDMode свойство текущего экземпляра элемента управления и любые его дочерние элементы для Inherit.(Наследуется от Control.)

System_CAPS_protmethodCreateChildControls()

Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки.(Наследуется от Control.)

System_CAPS_protmethodCreateControlCollection()

Создает коллекцию для хранения дочерних элементов управления.(Наследуется от DataSourceControl.)

System_CAPS_pubmethodDataBind()

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

System_CAPS_protmethodDataBind(Boolean)

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

System_CAPS_protmethodDataBindChildren()

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

System_CAPS_pubmethodDelete()

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

System_CAPS_pubmethodDispose()

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

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Заканчивает во время разработки трассировки визуализации данных.(Наследуется от Control.)

System_CAPS_protmethodEnsureChildControls()

Определяет, содержит ли элемент управления сервера дочерних элементов управления. Если нет, создает дочерние элементы управления.(Наследуется от Control.)

System_CAPS_protmethodEnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.(Наследуется от Control.)

System_CAPS_pubmethodEquals(Object)

Определяет, равен ли заданный объект текущему объекту.(Наследуется от Object.)

System_CAPS_protmethodFinalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.(Наследуется от Object.)

System_CAPS_pubmethodFindControl(String)

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

System_CAPS_protmethodFindControl(String, Int32)

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

System_CAPS_pubmethodFocus()

Устанавливает фокус ввода на элемент управления.(Наследуется от DataSourceControl.)

System_CAPS_protmethodGetDesignModeState()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Возвращает данные времени разработки для элемента управления.(Наследуется от Control.)

System_CAPS_pubmethodGetHashCode()

Служит хэш-функцией по умолчанию.(Наследуется от Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.(Наследуется от Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.(Наследуется от Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имя маршрута.(Наследуется от Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имя маршрута.(Наследуется от Control.)

System_CAPS_pubmethodGetType()

Возвращает объект Type для текущего экземпляра.(Наследуется от Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Возвращает в качестве префикса для UniqueID свойства указанного элемента управления.(Наследуется от Control.)

System_CAPS_protmethodGetView(String)

Возвращает именованное представление источника данных, связанный с элементом управления источником данных.(Переопределяет DataSourceControl.GetView(String).)

System_CAPS_protmethodGetViewNames()

Возвращает коллекцию имен, представляющих список объектов представления, которые связаны с ObjectDataSource объекта.(Переопределяет DataSourceControl.GetViewNames().)

System_CAPS_pubmethodHasControls()

Определяет, содержит ли элемент управления сервера дочерних элементов управления.(Наследуется от DataSourceControl.)

System_CAPS_protmethodHasEvents()

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

System_CAPS_pubmethodInsert()

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

System_CAPS_protmethodIsLiteralContent()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Определяет, если серверный элемент управления содержит только текстовое содержимое.(Наследуется от Control.)

System_CAPS_protmethodLoadControlState(Object)

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

System_CAPS_protmethodLoadViewState(Object)

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Загружает предварительно сохраненное состояние представления элемента управления ObjectDataSource.(Переопределяет Control.LoadViewState(Object).)

System_CAPS_protmethodMapPathSecure(String)

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

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

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

System_CAPS_protmethodOnDataBinding(EventArgs)

Вызывает событие DataBinding.(Наследуется от Control.)

System_CAPS_protmethodOnInit(EventArgs)

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

System_CAPS_protmethodOnLoad(EventArgs)

Вызывает событие Load.(Наследуется от Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Вызывает событие PreRender.(Наследуется от Control.)

System_CAPS_protmethodOnUnload(EventArgs)

Вызывает событие Unload.(Наследуется от Control.)

System_CAPS_protmethodOpenFile(String)

Возвращает Stream используется для чтения файла.(Наследуется от Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

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

System_CAPS_protmethodRaiseDataSourceChangedEvent(EventArgs)

Вызывает событие DataSourceChanged.(Наследуется от DataSourceControl.)

System_CAPS_protmethodRemovedControl(Control)

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

System_CAPS_protmethodRender(HtmlTextWriter)

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

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

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

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

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

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

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

System_CAPS_protmethodResolveAdapter()

Возвращает адаптер элемента управления, ответственный за визуализацию указанного элемента управления.(Наследуется от Control.)

System_CAPS_pubmethodResolveClientUrl(String)

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

System_CAPS_pubmethodResolveUrl(String)

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

System_CAPS_protmethodSaveControlState()

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

System_CAPS_protmethodSaveViewState()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Сохраняет состояние элемента управления ObjectDataSource.(Переопределяет Control.SaveViewState().)

System_CAPS_pubmethodSelect()

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

System_CAPS_protmethodSetDesignModeState(IDictionary)

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

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого в родительский элемент управления.(Наследуется от Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

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

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Задает данные для разработки трассировка визуализации данных, используя объект трассировки, ключ данных трассировки и значение данных трассировки трассировки.(Наследуется от Control.)

System_CAPS_pubmethodToString()

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

System_CAPS_protmethodTrackViewState()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Отслеживает изменения состояния представления в ObjectDataSource элементе управления, которая может храниться в System.Web.UI.StateBag объекта.(Переопределяет Control.TrackViewState().)

System_CAPS_pubmethodUpdate()

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

ИмяОписание
System_CAPS_pubeventDataBinding

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

System_CAPS_pubeventDeleted

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

System_CAPS_pubeventDeleting

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

System_CAPS_pubeventDisposed

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

System_CAPS_pubeventFiltering

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

System_CAPS_pubeventInit

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

System_CAPS_pubeventInserted

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

System_CAPS_pubeventInserting

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

System_CAPS_pubeventLoad

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

System_CAPS_pubeventObjectCreated

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

System_CAPS_pubeventObjectCreating

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

System_CAPS_pubeventObjectDisposing

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

System_CAPS_pubeventPreRender

Происходит после Control объект загружен, но до подготовки к просмотру.(Наследуется от Control.)

System_CAPS_pubeventSelected

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

System_CAPS_pubeventSelecting

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

System_CAPS_pubeventUnload

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

System_CAPS_pubeventUpdated

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

System_CAPS_pubeventUpdating

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

ИмяОписание
System_CAPS_pubinterfaceSystem_CAPS_priveventIDataSource.DataSourceChanged

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Происходит при изменении элемента управления источником данных в виде, влияет на элементы управления с привязкой к данным.(Наследуется от DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIListSource.GetList()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Возвращает список элементов управления источниками данных, которые могут использоваться в качестве источников списков данных.(Наследуется от DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе IControlDesignerAccessor.GetDesignModeState.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе IControlDesignerAccessor.SetDesignModeState.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Описание этого члена см. в разделе IControlDesignerAccessor.SetOwnerControl.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetView(String)

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Возвращает именованный DataSourceView объекта, связанного с DataSourceControl управления. Некоторые управляющие элементы источников данных поддерживают только одно представление, хотя другие поддерживают более одного.(Наследуется от DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetViewNames()

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Возвращает коллекцию имен, представляющих список DataSourceView объекты, связанные с DataSourceControl управления.(Наследуется от DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе IParserAccessor.AddParsedSubObject.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIListSource.ContainsListCollection

Этот API поддерживает инфраструктуру продукт, и его не следует использовать напрямую из кода. Указывает, связан ли элемент управления источником данных с одним или несколькими списками данных.(Наследуется от DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе IControlBuilderAccessor.ControlBuilder.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Описание этого члена см. в разделе IControlDesignerAccessor.UserData.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе IDataBindingsAccessor.DataBindings.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе IDataBindingsAccessor.HasDataBindings.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Описание этого члена см. в разделе IExpressionsAccessor.Expressions.(Наследуется от Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе IExpressionsAccessor.HasExpressions.(Наследуется от Control.)

ИмяОписание
System_CAPS_pubmethodFindDataSourceControl()

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

System_CAPS_pubmethodFindFieldTemplate(String)

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

System_CAPS_pubmethodFindMetaTable()

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

System_CAPS_pubmethodGetDefaultValues()

Перегружен. Возвращает коллекцию значений по умолчанию для указанного источника данных.(Определено DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Перегружен. Возвращает метаданные для таблицы в заданном объекте источника данных.(Определено DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Перегружен. Определяет, доступен ли метаданные таблицы.(Определено DynamicDataExtensions.)

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

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

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

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

System_CAPS_noteПримечание

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

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

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

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

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

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 интерфейс.

Updating

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

Deleting

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

Вставка

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

Кэширование

Задать EnableCaching свойства trueи CacheDuration и CacheExpirationPolicy свойства в соответствии с поведение кэширования для кэшированных данных.

System_CAPS_noteПримечание

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

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

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

Можно также использовать ObjectDataSource управления с платформой Entity Framework. Дополнительные сведения см. в разделе Using the Entity Framework and the ObjectDataSource Control.

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

Проект Visual Studio Web сайта с исходным кодом доступен по следующему адресу: Download.

В этом разделе показано 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>

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

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

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

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

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

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) { }
  }
}

.NET Framework
Доступно с 2.0

Любые открытые статические элементы ( Предоставлен общий доступ в Visual Basic) этого типа являются потокобезопасными. Потокобезопасность элементов экземпляров не гарантируется.

Вернуться в начало
Показ: