AccessDataSourceDesigner Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления веб-сервера AccessDataSource.
public ref class AccessDataSourceDesigner : System::Web::UI::Design::WebControls::SqlDataSourceDesigner
public class AccessDataSourceDesigner : System.Web.UI.Design.WebControls.SqlDataSourceDesigner
type AccessDataSourceDesigner = class
inherit SqlDataSourceDesigner
Public Class AccessDataSourceDesigner
Inherits SqlDataSourceDesigner
- Наследование
-
AccessDataSourceDesigner
Примеры
В этом разделе приведено два примера кода. В первом примере показано, как расширить AccessDataSourceDesigner класс . Второй демонстрирует, как создать копию AccessDataSource класса и связать ее с конструктором.
В следующем примере кода показано, как расширить AccessDataSourceDesigner класс . Код изменяет заполнитель, представляющий элемент управления в области конструктора, и добавляет свойство в сетку Свойства .
// Shadow control properties with design time properties.
protected override void PreFilterProperties(IDictionary properties)
{
// Call the base class method first.
base.PreFilterProperties(properties);
// Add the ConnectionString property to the property grid.
PropertyDescriptor property =
(PropertyDescriptor)properties["ConnectionString"];
Attribute[] attributes = new Attribute[]
{
new BrowsableAttribute(true),
new ReadOnlyAttribute(true)
};
properties["ConnectionString"] = TypeDescriptor.CreateProperty(
GetType(), property, attributes);
}
' Shadow control properties with design time properties.
Protected Overrides Sub PreFilterProperties(ByVal properties As IDictionary)
' Call the base class method first.
MyBase.PreFilterProperties(properties)
' Add the ConnectionString property to the property grid.
Dim prop As PropertyDescriptor
prop = CType(properties("ConnectionString"), PropertyDescriptor)
Dim atts(1) As Attribute
atts(0) = New BrowsableAttribute(True)
atts(1) = New ReadOnlyAttribute(True)
properties("ConnectionString") = TypeDescriptor.CreateProperty( _
prop.GetType(), prop, atts)
End Sub
В следующем примере кода показано, как создать копию AccessDataSource класса и связать ее с конструктором, определенным в предыдущем примере.
// Create a control and bind it to the ExampleAccessDataSourceDesigner.
[AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(CustomControls.Design.ExampleAccessDataSourceDesigner))]
public class ExampleAccessDataSource : AccessDataSource
{
// Does nothing extra
}
' Create a control and bind it to the ExampleAccessDataSourceDesigner.
<AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand, _
Level:=System.Web.AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, _
Level:=System.Web.AspNetHostingPermissionLevel.Minimal)> _
<Designer("CustomControls.Design.ExampleAccessDataSourceDesigner")> _
Public Class ExampleAccessDataSource
Inherits AccessDataSource
' Does nothing extra
End Class
Комментарии
В визуальном конструкторе при переключении из исходного представления в конструктор исходный код разметки AccessDataSource , описывающий элемент управления, анализируется, а в области конструктора создается версия элемента управления времени разработки, которая является просто заполнителем. При переключении обратно в исходное представление элемент управления времени разработки, включающий значения свойств в сетке Свойства , сохраняется в исходном коде разметки и редактируется в разметке веб-страницы.
Конструкторы
| AccessDataSourceDesigner() |
Инициализирует новый экземпляр класса AccessDataSource. |
Свойства
| ActionLists |
Получает список элементов, используемых для создания меню списка действий во время разработки. (Унаследовано от DataSourceDesigner) |
| AllowResize |
Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner) |
| AssociatedComponents |
Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором. (Унаследовано от ComponentDesigner) |
| AutoFormats |
Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
| Behavior |
Устаревшие..
Получает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner) |
| CanConfigure |
Получает значение, указывающее возможность вызова метода Configure() узлом разработки. (Унаследовано от SqlDataSourceDesigner) |
| CanRefreshSchema |
Получает значение, указывающее возможность вызова метода RefreshSchema(Boolean) узлом разработки. (Унаследовано от SqlDataSourceDesigner) |
| Component |
Возвращает основной компонент, создаваемый данным конструктором. (Унаследовано от ComponentDesigner) |
| ConnectionString |
Получает или задает строку, используемую для открытия базы данных. (Унаследовано от SqlDataSourceDesigner) |
| DataBindings |
Получает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner) |
| DataBindingsEnabled |
Получает значение, указывающее, поддерживается ли привязка данных областью, содержащей элемент управления. (Унаследовано от ControlDesigner) |
| DataFile |
Реализует свойство конструктора таким образом, чтобы оно замещало свойство DataFile сопоставленного элемента управления. |
| DeleteQuery |
Получает или задает объект SqlDataSourceDesigner, который поддерживает запросы удаления. (Унаследовано от SqlDataSourceDesigner) |
| DesignerState |
Получает объект, используемый для сохранения данных сопоставленного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
| DesignTimeElement |
Устаревшие..
Возвращает объект времени разработки, представляющий элемент управления, сопоставленный с объектом HtmlControlDesigner в области разработки. (Унаследовано от HtmlControlDesigner) |
| DesignTimeElementView |
Устаревшие..
Получает объект элемента управления представлением для конструктора элементов управления. (Унаследовано от ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Устаревшие..
Получает значение, указывающее, должна ли быть завершена загрузка основным приложением разработки до вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |
| Expressions |
Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Получает значение, указывающее, скрыты ли свойства сопоставленного элемента управления, когда он находится в режиме шаблона. (Унаследовано от ControlDesigner) |
| ID |
Получает или задает строку идентификатора элемента управления. (Унаследовано от ControlDesigner) |
| InheritanceAttribute |
Возвращает атрибут, обозначающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner) |
| Inherited |
Возвращает значение, определяющее, наследуется ли этот компонент или нет. (Унаследовано от ComponentDesigner) |
| InsertQuery |
Получает или задает объект SqlDataSourceDesigner, который поддерживает запросы вставки. (Унаследовано от SqlDataSourceDesigner) |
| InTemplateMode |
получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в основном приложении разработки. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner) |
| IsDirty |
Устаревшие..
Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления. (Унаследовано от ControlDesigner) |
| ParentComponent |
Возвращает родительский компонент этого конструктора. (Унаследовано от ComponentDesigner) |
| ProviderName |
Получает или задает имя поставщика данных .NET Framework, который используется связанным элементом управления SqlDataSource для подключения к выделенному источнику данных. (Унаследовано от SqlDataSourceDesigner) |
| ReadOnly |
Устаревшие..
Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки. (Унаследовано от ControlDesigner) |
| RootDesigner |
Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
| SelectCommand |
Получает или задает SQL-запрос в соответствующем объекте SqlDataSource для выбора данных из выделенной базы данных. (Унаследовано от SqlDataSourceDesigner) |
| SelectQuery |
Получает или задает объект SqlDataSourceDesigner, который поддерживает запросы выбора. (Унаследовано от SqlDataSourceDesigner) |
| SetTextualDefaultProperty |
Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления веб-сервера AccessDataSource. (Унаследовано от ComponentDesigner) |
| ShadowProperties |
Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner) |
| ShouldCodeSerialize |
Устаревшие..
Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Получает значение, показывающее, происходит ли событие DataSourceChanged или метод RefreshSchema(Boolean). (Унаследовано от DataSourceDesigner) |
| Tag |
Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
| TemplateGroups |
Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner) |
| UpdateQuery |
Получает или задает объект SqlDataSourceDesigner, который поддерживает запросы обновления. (Унаследовано от SqlDataSourceDesigner) |
| UsePreviewControl |
Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner) |
| Verbs |
Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner) |
| ViewControl |
Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner) |
| ViewControlCreated |
Получает или задает значение, указывающее, создан ли элемент управления |
| Visible |
Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner) |
Методы
| Configure() |
Запускает служебную программу конфигурации источника данных на узле разработки. (Унаследовано от SqlDataSourceDesigner) |
| CreateErrorDesignTimeHtml(String) |
Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner) |
| CreateView(String) |
Создает новый экземпляр класса SqlDesignerDataSourceView с использованием заданного имени. (Унаследовано от SqlDataSourceDesigner) |
| CreateViewControl() |
Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner) |
| DeriveParameters(String, DbCommand) |
Извлекает параметры из заданной команды SQL и добавляет соответствующие объекты Parameter в коллекцию параметров этой команды. (Унаследовано от SqlDataSourceDesigner) |
| Dispose() |
Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner) |
| Dispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner. (Унаследовано от HtmlControlDesigner) |
| DoDefaultAction() |
Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetBounds() |
Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner) |
| GetConnectionString() |
Получает строку подключения, которая является допустимой во время разработки для элемента управления, связанного с этим конструктором. |
| 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) |
Извлекает объект DesignerDataSourceView, определяемый именем представления. (Унаследовано от SqlDataSourceDesigner) |
| GetViewNames() |
Получает список доступных представлений. (Унаследовано от SqlDataSourceDesigner) |
| GetViewRendering() |
Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
| InferParameterNames(DesignerDataConnection, String, SqlDataSourceCommandType) |
Возвращает массив параметров с использованием заданного подключения, текста команды и типа команды. (Унаследовано от SqlDataSourceDesigner) |
| 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) |
Обновляет схему на основе выделенного источника данных. (Унаследовано от SqlDataSourceDesigner) |
| 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) |