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 атрибут для MyObjectDataSourceDesignerMyObjectDataSource элемента управления.
Переопределяет MyObjectDataSourceDesignerPreFilterProperties метод, чтобы сделать NamingContainer свойство видимым в сетке свойств во время разработки.
Переопределяет MyObjectDataSourceDesignerGetDesignTimeHtml метод для отображения 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() вызове метода связанного элемента управления. |
| 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, Exception) |
Создает разметку HTML для отображения указанного сообщения об ошибке исключения во время разработки. (Унаследовано от ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Создает разметку 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) |
| 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) |