ObjectDataSourceDesigner Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления веб-сервера ObjectDataSource.
public ref class ObjectDataSourceDesigner : System::Web::UI::Design::DataSourceDesigner
public class ObjectDataSourceDesigner : System.Web.UI.Design.DataSourceDesigner
type ObjectDataSourceDesigner = class
inherit DataSourceDesigner
Public Class ObjectDataSourceDesigner
Inherits DataSourceDesigner
- Наследование
-
ObjectDataSourceDesigner
Примеры
В следующем примере кода показано, как расширить ObjectDataSourceDesigner класс, чтобы изменить внешний вид и поведение элементов управления, производных от ObjectDataSource элемента управления во время разработки.
В этом примере элемент управления является производным MyObjectDataSource
от ObjectDataSource. — MyObjectDataSource
это копия ObjectDataSource элемента управления . В примере также наследуется MyObjectDataSourceDesigner
класс от ObjectDataSourceDesigner и применяется DesignerAttribute атрибут для MyObjectDataSourceDesigner
MyObjectDataSource
элемента управления .
Переопределяет MyObjectDataSourceDesigner
метод , PreFilterProperties чтобы сделать NamingContainer свойство видимым в сетке Свойства во время разработки.
Переопределяет MyObjectDataSourceDesigner
GetDesignTimeHtml метод для отображения TypeName свойств и SelectMethod в заполнитель в дополнение к типу элемента управления и идентификатору.
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The MyObjectDataSource is a copy of the ObjectDataSource.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
MyObjectDataSourceDesigner))]
public class MyObjectDataSource : ObjectDataSource
{
} // MyObjectDataSource
// Derive a designer that inherits from the ObjectDataSourceDesigner.
[ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
public class MyObjectDataSourceDesigner : ObjectDataSourceDesigner
{
// Generate the design-time markup.
public override string GetDesignTimeHtml()
{
// Get a reference to the control or a copy of the control.
MyObjectDataSource myODS = (MyObjectDataSource)ViewControl;
// Create a placeholder that displays the type of the business
// object and the name of the Select method.
string markup = CreatePlaceHolderDesignTimeHtml(
"<b>TypeName</b> \"" + myODS.TypeName + "\"<br />" +
"<b>SelectMethod</b> \"" + myODS.SelectMethod + "\"" );
return markup;
} // GetDesignTimeHtml
// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
{
// Call the base method first.
base.PreFilterProperties(properties);
// Make the NamingContainer visible in the Properties grid.
PropertyDescriptor selectProp =
(PropertyDescriptor)properties["NamingContainer"];
properties["NamingContainer"] =
TypeDescriptor.CreateProperty(selectProp.ComponentType,
selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties
} // MyObjectDataSourceDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The MyObjectDataSource is a copy of the ObjectDataSource.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
MyObjectDataSourceDesigner))> _
Public Class MyObjectDataSource
Inherits ObjectDataSource
End Class
' Derive a designer that inherits from the ObjectDataSourceDesigner.
<ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
Public Class MyObjectDataSourceDesigner
Inherits ObjectDataSourceDesigner
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml() As String
' Get a reference to the control or a copy of the control.
Dim myODS As MyObjectDataSource = _
CType(ViewControl, MyObjectDataSource)
Dim markup As String = _
CreatePlaceHolderDesignTimeHtml( _
"<b>TypeName</b> """ & myODS.TypeName & """<br />" & _
"<b>SelectMethod</b> """ & myODS.SelectMethod & """")
Return markup
End Function ' GetDesignTimeHtml
' Shadow the control properties with design-time properties.
Protected Overrides Sub PreFilterProperties( _
ByVal properties As IDictionary)
' Call the base method first.
MyBase.PreFilterProperties(properties)
' Make the NamingContainer visible in the Properties grid.
Dim selectProp As PropertyDescriptor = _
CType(properties("NamingContainer"), PropertyDescriptor)
properties("NamingContainer") = _
TypeDescriptor.CreateProperty(selectProp.ComponentType, _
selectProp, BrowsableAttribute.Yes)
End Sub
End Class
End Namespace ' Examples.VB.WebControls.Design
Комментарии
Элемент ObjectDataSource управления представляет источник данных, который вызывает методы бизнес-объекта для выполнения операций удаления, вставки, выбора и обновления базы данных.
В визуальном конструкторе при переключении из режима "Источник" в режим конструктора выполняется анализ исходного кода разметки ObjectDataSource , описывающего элемент управления, и в области конструктора создается версия элемента управления во время разработки. При переключении обратно в исходное представление элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметке для веб-страницы. Класс ObjectDataSourceDesigner обеспечивает поддержку элемента управления во время разработки ObjectDataSource в визуальном конструкторе.
Члены ObjectDataSourceDesigner класса предоставляют следующие функциональные возможности:
Свойство CanConfigure указывает, может ли отображаться мастер настройки источника данных. Свойство CanRefreshSchema указывает, можно ли обновить схему связанного ObjectDataSource элемента управления во время разработки.
Свойство SelectMethod указывает метод, выполняющий функцию Select. Свойство TypeName указывает тип бизнес-объекта, предоставляющего данные для связанного элемента управления.
Метод GetView возвращает представление источника данных с указанным именем. Метод GetViewNames возвращает список имен представлений источников данных для связанного ObjectDataSource элемента управления. Метод RefreshSchema извлекает метаданные для метода Select из связанного бизнес-объекта.
Метод Configure приводит к отображению мастера настройки источника данных в области визуального конструктора. Метод PreFilterProperties удаляет свойства из , добавляет дополнительные свойства в или затемняет свойства связанного элемента управления.
Конструкторы
ObjectDataSourceDesigner() |
Инициализирует новый экземпляр класса ObjectDataSourceDesigner. |
Свойства
ActionLists |
Получает список элементов, используемых для создания меню списка действий во время разработки. (Унаследовано от DataSourceDesigner) |
AllowResize |
Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner) |
AssociatedComponents |
Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором. (Унаследовано от ComponentDesigner) |
AutoFormats |
Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Behavior |
Устаревшие..
Получает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner) |
CanConfigure |
Возвращает значение, которое указывает, может ли быть вызван метод Configure(). |
CanRefreshSchema |
Возвращает значение, которое указывает, может ли быть вызван метод RefreshSchema(Boolean). |
Component |
Возвращает основной компонент, создаваемый данным конструктором. (Унаследовано от ComponentDesigner) |
DataBindings |
Получает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner) |
DataBindingsEnabled |
Получает значение, указывающее, поддерживается ли привязка данных областью, содержащей элемент управления. (Унаследовано от ControlDesigner) |
DesignerState |
Получает объект, используемый для сохранения данных сопоставленного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
DesignTimeElement |
Устаревшие..
Возвращает объект времени разработки, представляющий элемент управления, сопоставленный с объектом HtmlControlDesigner в области разработки. (Унаследовано от HtmlControlDesigner) |
DesignTimeElementView |
Устаревшие..
Получает объект элемента управления представлением для конструктора элементов управления. (Унаследовано от ControlDesigner) |
DesignTimeHtmlRequiresLoadComplete |
Устаревшие..
Получает значение, указывающее, должна ли быть завершена загрузка основным приложением разработки до вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |
Expressions |
Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner) |
HidePropertiesInTemplateMode |
Получает значение, указывающее, скрыты ли свойства сопоставленного элемента управления, когда он находится в режиме шаблона. (Унаследовано от ControlDesigner) |
ID |
Получает или задает строку идентификатора элемента управления. (Унаследовано от ControlDesigner) |
InheritanceAttribute |
Возвращает атрибут, обозначающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner) |
Inherited |
Возвращает значение, определяющее, наследуется ли этот компонент или нет. (Унаследовано от ComponentDesigner) |
InTemplateMode |
получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в основном приложении разработки. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner) |
IsDirty |
Устаревшие..
Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления. (Унаследовано от ControlDesigner) |
ParentComponent |
Возвращает родительский компонент этого конструктора. (Унаследовано от ComponentDesigner) |
ReadOnly |
Устаревшие..
Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки. (Унаследовано от ControlDesigner) |
RootDesigner |
Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
SelectMethod |
Получает или задает имя метода, который должен выполняться при вызове метода Select() сопоставленного элемента управления. |
SetTextualDefaultProperty |
Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления веб-сервера ObjectDataSource. (Унаследовано от ComponentDesigner) |
ShadowProperties |
Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner) |
ShouldCodeSerialize |
Устаревшие..
Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner) |
SuppressingDataSourceEvents |
Получает значение, показывающее, происходит ли событие DataSourceChanged или метод RefreshSchema(Boolean). (Унаследовано от DataSourceDesigner) |
Tag |
Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
TemplateGroups |
Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner) |
TypeName |
Получает или задает имя типа, содержащего методы, заданные в сопоставленном элементе управления. |
UsePreviewControl |
Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner) |
Verbs |
Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner) |
ViewControl |
Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner) |
ViewControlCreated |
Получает или задает значение, указывающее, создан ли элемент управления |
Visible |
Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner) |
Методы
Configure() |
Отображает в области визуального конструктора мастер настройки источника данных. |
CreateErrorDesignTimeHtml(String) |
Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner) |
CreateViewControl() |
Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner) |
Dispose() |
Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner) |
Dispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner. (Унаследовано от HtmlControlDesigner) |
DoDefaultAction() |
Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetBounds() |
Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner) |
GetDesignTimeHtml() |
Возвращает разметку HTML для отображения связанного элемента управления источника данных во время разработки. (Унаследовано от DataSourceDesigner) |
GetDesignTimeHtml(DesignerRegionCollection) |
Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления. (Унаследовано от ControlDesigner) |
GetEditableDesignerRegionContent(EditableDesignerRegion) |
Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner) |
GetEmptyDesignTimeHtml() |
Извлекает разметку HTML, используемую для представления северного веб-элемента управления во время разработки, у которого не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner) |
GetErrorDesignTimeHtml(Exception) |
Получает HTML-разметку, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetPersistenceContent() |
Получает сохраненную внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner) |
GetPersistInnerHtml() |
Устаревшие..
Получает сохраненную внутреннюю разметку HTML элемента управления. (Унаследовано от ControlDesigner) |
GetService(Type) |
Пытается извлечь службу заданного типа с узла режима разработки компонента конструктора. (Унаследовано от ComponentDesigner) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
GetView(String) |
Возвращает представление источника данных с заданным именем. |
GetViewNames() |
Возвращает список имен представлений источника данных для сопоставленного элемента управления. |
GetViewRendering() |
Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
Initialize(IComponent) |
Инициализирует конструктор элементов управления и загружает указанный компонент. (Унаследовано от ControlDesigner) |
InitializeExistingComponent(IDictionary) |
Выполняет повторную инициализацию существующего компонента. (Унаследовано от ComponentDesigner) |
InitializeNewComponent(IDictionary) |
Инициализирует только что созданный компонент. (Унаследовано от ComponentDesigner) |
InitializeNonDefault() |
Устаревшие..
Устаревшие..
Инициализирует параметры импортированного компонента, параметры которого уже были инициализированы с использованием параметров, отличных от заданных по умолчанию. (Унаследовано от ComponentDesigner) |
Invalidate() |
Делает недействительной целую область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элементов управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner) |
Invalidate(Rectangle) |
Делает недействительной указанную область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элемента управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner) |
InvokeGetInheritanceAttribute(ComponentDesigner) |
Возвращает атрибут InheritanceAttribute заданного объекта ComponentDesigner. (Унаследовано от ComponentDesigner) |
IsPropertyBound(String) |
Устаревшие..
Получает значение, указывающее, является ли указанное свойство сопоставленного элемента управления привязанным к данным. (Унаследовано от ControlDesigner) |
Localize(IDesignTimeResourceWriter) |
Использует предоставленный модуль записи ресурсов для сохранения локализуемых свойств сопоставленного элемента управления в ресурсе основного приложения разработки. (Унаследовано от ControlDesigner) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
OnAutoFormatApplied(DesignerAutoFormat) |
Вызывается, когда предварительно определенная схема автоматического форматирования применяется к сопоставленному элементу управления. (Унаследовано от ControlDesigner) |
OnBehaviorAttached() |
Вызывается, когда конструктор элемента управления вложен в объект Behavior. (Унаследовано от ControlDesigner) |
OnBehaviorDetaching() |
Устаревшие..
Вызывается при разрыве связи поведения и элемента. (Унаследовано от HtmlControlDesigner) |
OnBindingsCollectionChanged(String) |
Устаревшие..
Вызывается при изменении коллекции привязки данных. (Унаследовано от ControlDesigner) |
OnClick(DesignerRegionMouseEventArgs) |
Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Вызывается при изменении сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
OnComponentChanging(Object, ComponentChangingEventArgs) |
Предоставляет метод, обрабатывающий событие ComponentChanging для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
OnControlResize() |
Устаревшие..
Вызывается, когда изменяется размер сопоставленного серверного веб-элемента управления в основном приложении разработки во время разработки. (Унаследовано от ControlDesigner) |
OnDataSourceChanged(EventArgs) |
Вызывает событие DataSourceChanged, если свойства источника данных были изменены и значение свойства SuppressingDataSourceEvents равно |
OnPaint(PaintEventArgs) |
Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является |
OnSchemaRefreshed(EventArgs) |
Вызывает событие SchemaRefreshed, если схема источника данных была изменена и значение свойства SuppressingDataSourceEvents равно |
OnSetComponentDefaults() |
Устаревшие..
Устаревшие..
Задает для компонента свойства по умолчанию. (Унаследовано от ComponentDesigner) |
OnSetParent() |
Предоставляет способ выполнения дополнительной обработки, когда сопоставленный элемент управления сопоставляется с родительским элементом управления. (Унаследовано от HtmlControlDesigner) |
PostFilterAttributes(IDictionary) |
Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner) |
PostFilterEvents(IDictionary) |
Позволяет конструктору изменять или удалять элементы из набора событий, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner) |
PostFilterProperties(IDictionary) |
Позволяет конструктору изменять или удалять элементы из набора свойств, предоставленных с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner) |
PreFilterAttributes(IDictionary) |
Позволяет конструктору добавлять элементы к набору атрибутов, предоставленному с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner) |
PreFilterEvents(IDictionary) |
Определяет список событий, предоставляемых во время разработки для объекта TypeDescriptor компонента. (Унаследовано от HtmlControlDesigner) |
PreFilterProperties(IDictionary) |
Используется в конструкторе для добавления дополнительных свойств в сетку Свойства или удаления их оттуда, а также для затемнения свойств связанного элемента управления. |
RaiseComponentChanged(MemberDescriptor, Object, Object) |
Уведомляет службу IComponentChangeService о том, что данный компонент был изменен. (Унаследовано от ComponentDesigner) |
RaiseComponentChanging(MemberDescriptor) |
Уведомляет службу IComponentChangeService о том, что компонент будет изменен. (Унаследовано от ComponentDesigner) |
RaiseResizeEvent() |
Устаревшие..
Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner) |
RefreshSchema(Boolean) |
Извлекает метаданные для метода Select из бизнес-объекта, который задан сопоставленным элементом управления. |
RegisterClone(Object, Object) |
Регистрирует внутренние данные в клонированном элементе управления. (Унаследовано от ControlDesigner) |
ResumeDataSourceEvents() |
Восстанавливает события источников данных после их подавления. (Унаследовано от DataSourceDesigner) |
SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner) |
SetRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner) |
SetViewFlags(ViewFlags, Boolean) |
Назначает указанное битовое перечисление ViewFlags указанному значению флага. (Унаследовано от ControlDesigner) |
SuppressDataSourceEvents() |
Откладывает все события источника данных до вызова метода ResumeDataSourceEvents(). (Унаследовано от DataSourceDesigner) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
UpdateDesignTimeHtml() |
Обновляет разметку HTML времени разработки для сопоставленного серверного веб-элемента управления посредством вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |
События
DataSourceChanged |
Происходит при изменении любого свойства связанного источника данных. (Унаследовано от DataSourceDesigner) |
SchemaRefreshed |
Происходит после обновления схемы. (Унаследовано от DataSourceDesigner) |