BaseValidatorDesigner Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет поддержку во время разработки в визуальном конструкторе для серверных веб-элементов управления, производных от класса BaseValidator.
public ref class BaseValidatorDesigner : System::Web::UI::Design::ControlDesigner
public ref class BaseValidatorDesigner : System::Web::UI::Design::WebControls::PreviewControlDesigner
public class BaseValidatorDesigner : System.Web.UI.Design.ControlDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class BaseValidatorDesigner : System.Web.UI.Design.WebControls.PreviewControlDesigner
type BaseValidatorDesigner = class
inherit ControlDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type BaseValidatorDesigner = class
inherit PreviewControlDesigner
Public Class BaseValidatorDesigner
Inherits ControlDesigner
Public Class BaseValidatorDesigner
Inherits PreviewControlDesigner
- Наследование
- Наследование
-
BaseValidatorDesigner
- Атрибуты
Примеры
В следующем примере элемент управления является производным SimpleCompareValidator
CompareValidator от класса .
SimpleCompareValidator
— это копия CompareValidator. В этом примере конструктор также является производным SimpleCompareValidatorDesigner
BaseValidatorDesigner от класса и использует DesignerAttribute атрибут для связывания SimpleCompareValidatorDesigner
класса с элементом SimpleCompareValidator
управления .
SimpleCompareValidatorDesigner
Переопределяет метод для рисования GetDesignTimeHtml сплошной границы вокруг SimpleCompareValidator
элемента управления во время разработки BorderStyle , если значением свойства элемента управления является NotSet поле или None .
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The SimpleCompareValidator is a copy of the CompareValidator.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
SimpleCompareValidatorDesigner))]
public class SimpleCompareValidator : CompareValidator
{
} // SimpleCompareValidator
// Derive a designer that inherits from the BaseValidatorDesigner.
public class SimpleCompareValidatorDesigner : BaseValidatorDesigner
{
// Make the full extent of the control more visible in the designer.
// If the border style is None or NotSet, change the border to a
// solid line.
public override string GetDesignTimeHtml()
{
// Get a reference to the control or a copy of the control.
SimpleCompareValidator myCV = (SimpleCompareValidator)ViewControl;
string markup = null;
// Check if the border style should be changed.
if (myCV.BorderStyle == BorderStyle.NotSet ||
myCV.BorderStyle == BorderStyle.None)
{
// Save the current property setting.
BorderStyle oldBorderStyle = myCV.BorderStyle;
// Set the design-time property and catch any exceptions.
try
{
myCV.BorderStyle = BorderStyle.Solid;
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
markup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the property to its original setting.
myCV.BorderStyle = oldBorderStyle;
}
}
else
{
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
return markup;
} // GetDesignTimeHtml
} // SimpleCompareValidatorDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The SimpleCompareValidator is a copy of the CompareValidator.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
SimpleCompareValidatorDesigner))> _
Public Class SimpleCompareValidator
Inherits CompareValidator
End Class
' Derive a designer that inherits from the BaseValidatorDesigner.
Public Class SimpleCompareValidatorDesigner
Inherits BaseValidatorDesigner
' Make the full extent of the control more visible in the designer.
' If the border style is None or NotSet, change the border to a
' solid line.
Public Overrides Function GetDesignTimeHtml() As String
' Get a reference to the control or a copy of the control.
Dim myCV As SimpleCompareValidator = _
CType(ViewControl, SimpleCompareValidator)
Dim markup As String
' Check if the border style should be changed.
If (myCV.BorderStyle = BorderStyle.NotSet Or _
myCV.BorderStyle = BorderStyle.None) Then
' Save the current property setting.
Dim oldBorderStyle As BorderStyle = myCV.BorderStyle
' Set the design-time property and catch any exceptions.
Try
myCV.BorderStyle = BorderStyle.Solid
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
markup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the property to its original setting.
myCV.BorderStyle = oldBorderStyle
End Try
Else
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
End If
Return markup
End Function
End Class
End Namespace ' Examples.VB.WebControls.Design
Комментарии
В визуальном конструкторе при переключении из исходного представления в режим конструктора исходный код разметки, описывающий элемент управления, производный от BaseValidator абстрактного класса, анализируется, и в области конструктора создается версия элемента управления во время разработки. При переключении обратно в представление источника элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметке для веб-страницы. Объекты BaseValidatorDesigner обеспечивают поддержку во время разработки для элементов управления, производных от BaseValidator класса в визуальном конструкторе.
Метод GetDesignTimeHtml получает разметку, используемую для отрисовки связанного элемента управления во время разработки.
Конструкторы
BaseValidatorDesigner() |
Инициализирует новый экземпляр класса BaseValidatorDesigner. |
Свойства
ActionLists |
Получает коллекцию списков действий для конструктора элементов управления. (Унаследовано от ControlDesigner) |
AllowResize |
Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner) |
AssociatedComponents |
Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором. (Унаследовано от ComponentDesigner) |
AutoFormats |
Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Behavior |
Устаревшие..
Получает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner) |
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) |
SetTextualDefaultProperty |
Предоставляет поддержку во время разработки в визуальном конструкторе для серверных веб-элементов управления, производных от класса BaseValidator. (Унаследовано от ComponentDesigner) |
ShadowProperties |
Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner) |
ShouldCodeSerialize |
Устаревшие..
Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner) |
Tag |
Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
TemplateGroups |
Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner) |
UsePreviewControl |
Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner) |
UsePreviewControl |
Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки. (Унаследовано от PreviewControlDesigner) |
Verbs |
Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner) |
ViewControl |
Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner) |
ViewControlCreated |
Получает или задает значение, указывающее, создан ли элемент управления |
Visible |
Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner) |
Методы
CreateErrorDesignTimeHtml(String) |
Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner) |
CreateViewControl() |
Возвращает копию связанного элемента управления для отрисовки в рабочей области конструирования. |
CreateViewControl() |
Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner) |
Dispose() |
Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner) |
Dispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner. (Унаследовано от HtmlControlDesigner) |
DoDefaultAction() |
Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetBounds() |
Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner) |
GetDesignTimeHtml() |
Получает разметку, используемую для отрисовки связанного элемента управления во время разработки. |
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) |
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) |
OnPaint(PaintEventArgs) |
Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является |
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) |
Используется конструктором для добавления или удаления свойств в сетке свойств или для сокрытия свойств связанного элемента управления. |
PreFilterProperties(IDictionary) |
Добавляет свойства в сетку свойств в основном приложении разработки во время разработки или удаляет их из этой сетки либо предоставляет новые свойства времени разработки, которые могут соответствовать свойствам сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
RaiseComponentChanged(MemberDescriptor, Object, Object) |
Уведомляет службу IComponentChangeService о том, что данный компонент был изменен. (Унаследовано от ComponentDesigner) |
RaiseComponentChanging(MemberDescriptor) |
Уведомляет службу IComponentChangeService о том, что компонент будет изменен. (Унаследовано от ComponentDesigner) |
RaiseResizeEvent() |
Устаревшие..
Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner) |
RegisterClone(Object, Object) |
Регистрирует внутренние данные в клонированном элементе управления. (Унаследовано от ControlDesigner) |
SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner) |
SetRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner) |
SetViewFlags(ViewFlags, Boolean) |
Назначает указанное битовое перечисление ViewFlags указанному значению флага. (Унаследовано от ControlDesigner) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
UpdateDesignTimeHtml() |
Обновляет разметку HTML времени разработки для сопоставленного серверного веб-элемента управления посредством вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |