DataGridDesigner Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Расширяет реакцию на событие во время разработки для элемента управления веб-сервера DataGrid.
public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesigner
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner
type DataGridDesigner = class
inherit BaseDataListDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
inherit BaseDataListDesigner
Public Class DataGridDesigner
Inherits BaseDataListDesigner
- Наследование
- Атрибуты
Примеры
В следующем примере кода показано, как расширить DataGridDesigner класс . Код переопределяет GetDesignTimeHtml метод для настройки CellPaddingсвойств , BorderWidthи BorderColor при DataGrid отрисовки элемента управления в области конструктора.
Imports System.Diagnostics
Imports System.ComponentModel
Imports System.Drawing
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace Examples.AspNet
' Create a designer class for the SimpleDataList class.
<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.Demand, _
Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Class SimpleDataListDesigner
Inherits DataListDesigner
Private simpleList As SimpleDataList
' Override the GetDesignTimeHtml method to add style to the control
' on the design surface.
Public Overrides Function GetDesignTimeHtml() As String
' Cast the control to the Component property of the designer.
simpleList = CType(Component, SimpleDataList)
Dim designTimeHtml As String = Nothing
' Create variables to hold current property values.
Dim oldBorderWidth As Unit = simpleList.BorderWidth
Dim oldBorderColor As Color = simpleList.BorderColor
' Set the properties and generate the design-time HTML.
If (simpleList.Enabled) Then
Try
simpleList.BorderWidth = Unit.Point(5)
simpleList.BorderColor = Color.Purple
designTimeHtml = MyBase.GetDesignTimeHtml()
' Call the GetErrorDesignTimeHtml method if an
' exception occurs.
Catch ex As Exception
designTimeHtml = GetErrorDesignTimeHtml(ex)
' Return the properties to their original settings.
Finally
simpleList.BorderWidth = oldBorderWidth
simpleList.BorderColor = oldBorderColor
End Try
' If the list is not enabled, call the GetEmptyDesignTimeHtml
' method.
Else
designTimeHtml = GetEmptyDesignTimeHtml()
End If
Return designTimeHtml
End Function
Protected Overrides Function GetEmptyDesignTimeHtml() As String
Dim emptyText As String
' Check the CanEnterTemplateMode property to
' specify which text to display if ItemTemplate
' does not contain a value.
If CanEnterTemplateMode Then
emptyText = _
"<b>Either the Enabled property value is false " + _
"or you need to set the ItemTemplate for this " + _
"control.<br>Right-click to edit templates.</b>"
Else
emptyText = _
"<b>You cannot edit templates in this view.<br>" + _
"Switch to HTML view to define the ItemTemplate.</b>"
End If
Return CreatePlaceHolderDesignTimeHtml(emptyText)
End Function
' Generate HTML to indicate that an error has occurred.
Protected Overrides Function GetErrorDesignTimeHtml(ByVal exc As _
Exception) As String
Return CreatePlaceHolderDesignTimeHtml( _
"<b>An error occurred</b>.<br>Check to ensure that all " + _
"properties are valid.")
End Function
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
End Class
End Namespace
В следующем примере показано, как использовать атрибут для DesignerAttribute связывания конструктора с элементом DataGrid управления .
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
Конструкторы
DataGridDesigner() |
Инициализирует новый экземпляр класса DataGridDesigner. |
Свойства
ActionLists |
Получает коллекцию списков действий данного конструктора. (Унаследовано от BaseDataListDesigner) |
ActiveTemplateEditingFrame |
Устаревшие..
Получает активный фрейм редактирования шаблона. (Унаследовано от TemplatedControlDesigner) |
AllowResize |
Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner) |
AssociatedComponents |
Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором. (Унаследовано от ComponentDesigner) |
AutoFormats |
Получает объект DesignerAutoFormatCollection, сопоставленный этому конструктору. |
AutoFormats |
Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Behavior |
Устаревшие..
Получает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner) |
CanEnterTemplateMode |
Возвращает значение, показывающее, разрешает ли этот конструктор просмотр и редактирование шаблонов. (Унаследовано от TemplatedControlDesigner) |
Component |
Возвращает основной компонент, создаваемый данным конструктором. (Унаследовано от ComponentDesigner) |
DataBindings |
Получает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner) |
DataBindingsEnabled |
Возвращает значение, показывающее, разрешает ли конструктор привязку данных. (Унаследовано от TemplatedControlDesigner) |
DataKeyField |
Получает или задает значение ключевого поля данных сопоставленного элемента управления. (Унаследовано от BaseDataListDesigner) |
DataMember |
Получает или задает значение поля члена сопоставленного элемента управления. (Унаследовано от BaseDataListDesigner) |
DataSource |
Получает или задает значение свойства источника данных элемента управления. (Унаследовано от BaseDataListDesigner) |
DataSourceDesigner |
Получает конструктор источника данных, если таковой выбран для привязки данных. (Унаследовано от BaseDataListDesigner) |
DataSourceID |
Получает или задает версию конструктора свойства идентификатора источника данных и используется для замещения соответствующего свойства сопоставленного элемента управления. (Унаследовано от BaseDataListDesigner) |
DesignerState |
Получает объект, используемый для сохранения данных сопоставленного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
DesignerView |
Получает представление по умолчанию для источника данных, который привязан к сопоставленному элементу управления. (Унаследовано от BaseDataListDesigner) |
DesignTimeElement |
Устаревшие..
Возвращает объект времени разработки, представляющий элемент управления, сопоставленный с объектом HtmlControlDesigner в области разработки. (Унаследовано от HtmlControlDesigner) |
DesignTimeElementView |
Устаревшие..
Получает объект элемента управления представлением для конструктора элементов управления. (Унаследовано от ControlDesigner) |
DesignTimeHtmlRequiresLoadComplete |
Получает значение, указывающее, должна ли загрузка завершиться для отображения разметки времени разработки. (Унаследовано от BaseDataListDesigner) |
Expressions |
Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner) |
HidePropertiesInTemplateMode |
Возвращает значение, показывающее, будут ли свойства элемента управления скрыты во время размещения элемента управления в режиме редактирования шаблонов. (Унаследовано от TemplatedControlDesigner) |
ID |
Получает или задает строку идентификатора элемента управления. (Унаследовано от ControlDesigner) |
InheritanceAttribute |
Возвращает атрибут, обозначающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner) |
Inherited |
Возвращает значение, определяющее, наследуется ли этот компонент или нет. (Унаследовано от ComponentDesigner) |
InTemplateMode |
Устаревшие..
Возвращает значение, показывающее, находится ли документ конструктора в режиме шаблона. (Унаследовано от TemplatedControlDesigner) |
IsDirty |
Устаревшие..
Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления. (Унаследовано от ControlDesigner) |
ParentComponent |
Возвращает родительский компонент этого конструктора. (Унаследовано от ComponentDesigner) |
ReadOnly |
Устаревшие..
Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки. (Унаследовано от ControlDesigner) |
RootDesigner |
Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
SetTextualDefaultProperty |
Расширяет реакцию на событие во время разработки для элемента управления веб-сервера DataGrid. (Унаследовано от ComponentDesigner) |
ShadowProperties |
Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner) |
ShouldCodeSerialize |
Устаревшие..
Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner) |
Tag |
Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
TemplateGroups |
Возвращает коллекцию групп шаблонов, каждая из которых содержит определение шаблона. (Унаследовано от TemplatedControlDesigner) |
UsePreviewControl |
Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner) |
Verbs |
Возвращает или задает коллекцию команд, доступных для данного конструктора. (Унаследовано от BaseDataListDesigner) |
ViewControl |
Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner) |
ViewControlCreated |
Получает или задает значение, указывающее, создан ли элемент управления |
Visible |
Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner) |
Методы
CreateErrorDesignTimeHtml(String) |
Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner) |
CreateTemplateEditingFrame(TemplateEditingVerb) |
Устаревшие..
Создает фрейм редактирования шаблона с помощью заданной команды. |
CreateViewControl() |
Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner) |
Dispose() |
Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner) |
Dispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом DataGridDesigner. |
DoDefaultAction() |
Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner) |
EnterTemplateMode(ITemplateEditingFrame) |
Устаревшие..
Открывает определенный объект фрейма шаблона для редактирования в конструкторе. (Унаследовано от TemplatedControlDesigner) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
ExitTemplateMode(Boolean, Boolean, Boolean) |
Устаревшие..
Закрывает текущий активный фрейм редактирования шаблона после сохранения всех соответствующих изменений. (Унаследовано от TemplatedControlDesigner) |
GetBounds() |
Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner) |
GetCachedTemplateEditingVerbs() |
Устаревшие..
Получает кэшированные команды редактирования шаблона, доступные конструктору. |
GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Создает объект, который может использоваться в качестве источника данных во время разработки. (Унаследовано от BaseDataListDesigner) |
GetDesignTimeDataSource(Int32, Boolean) |
Создает объект, который может использоваться в качестве источника данных во время разработки. (Унаследовано от BaseDataListDesigner) |
GetDesignTimeHtml() |
Получает HTML-разметку, используемую для представления элемента управления DataGrid во время разработки. |
GetDesignTimeHtml(DesignerRegionCollection) |
Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления. (Унаследовано от ControlDesigner) |
GetEditableDesignerRegionContent(EditableDesignerRegion) |
Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner) |
GetEmptyDesignTimeHtml() |
Получает HTML-разметку, используемую для отображения пустого элемента управления во время разработки. |
GetErrorDesignTimeHtml(Exception) |
Возвращает HTML-разметку, отображаемую в режиме конструктора для заданного исключения, когда происходит ошибка при отрисовке элемента управления. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetPersistenceContent() |
Получает сохраненную внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner) |
GetPersistInnerHtml() |
Возвращает разметку для сохранения содержимого в сопоставленном серверном элементе управления времени выполнения. (Унаследовано от TemplatedControlDesigner) |
GetResolvedSelectedDataSource() |
Получает из сопоставленного контейнера элементов управления компонент источника данных, разрешенный в конкретный член данных. (Унаследовано от BaseDataListDesigner) |
GetSelectedDataSource() |
Получает компонент источника данных из сопоставленного контейнера источников управления. (Унаследовано от BaseDataListDesigner) |
GetService(Type) |
Пытается извлечь службу заданного типа с узла режима разработки компонента конструктора. (Унаследовано от ComponentDesigner) |
GetTemplateContainerDataItemProperty(String) |
Устаревшие..
Получает свойство элемента данных для контейнера шаблона. |
GetTemplateContainerDataSource(String) |
Устаревшие..
Получает источник данных контейнера шаблона. (Унаследовано от BaseDataListDesigner) |
GetTemplateContent(ITemplateEditingFrame, String, Boolean) |
Устаревшие..
Получает содержимое шаблона. |
GetTemplateEditingVerbs() |
Устаревшие..
Возвращает команды редактирования шаблона, доступные конструктору. (Унаследовано от TemplatedControlDesigner) |
GetTemplateFromText(String) |
Создает шаблон на основе заданного текста. (Унаследовано от TemplatedControlDesigner) |
GetTemplatePropertyParentType(String) |
Устаревшие..
Получает объект Type, соответствующий родительскому объекту заданного шаблона. |
GetTextFromTemplate(ITemplate) |
Возвращает строку текста, представляющую указанный шаблон. (Унаследовано от TemplatedControlDesigner) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
GetViewRendering() |
Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
Initialize(IComponent) |
Инициализирует конструктор заданным элементом управления DataGrid. |
InitializeExistingComponent(IDictionary) |
Выполняет повторную инициализацию существующего компонента. (Унаследовано от ComponentDesigner) |
InitializeNewComponent(IDictionary) |
Инициализирует только что созданный компонент. (Унаследовано от ComponentDesigner) |
InitializeNonDefault() |
Устаревшие..
Устаревшие..
Инициализирует параметры импортированного компонента, параметры которого уже были инициализированы с использованием параметров, отличных от заданных по умолчанию. (Унаследовано от ComponentDesigner) |
Invalidate() |
Делает недействительной целую область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элементов управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner) |
Invalidate(Rectangle) |
Делает недействительной указанную область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элемента управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner) |
InvokeGetInheritanceAttribute(ComponentDesigner) |
Возвращает атрибут InheritanceAttribute заданного объекта ComponentDesigner. (Унаследовано от ComponentDesigner) |
InvokePropertyBuilder(Int32) |
Выполняет обращение к редактору компонентов для сопоставленного элемента управления. (Унаследовано от BaseDataListDesigner) |
IsPropertyBound(String) |
Устаревшие..
Получает значение, указывающее, является ли указанное свойство сопоставленного элемента управления привязанным к данным. (Унаследовано от ControlDesigner) |
Localize(IDesignTimeResourceWriter) |
Использует предоставленный модуль записи ресурсов для сохранения локализуемых свойств сопоставленного элемента управления в ресурсе основного приложения разработки. (Унаследовано от ControlDesigner) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
OnAutoFormat(Object, EventArgs) |
Устаревшие..
Обрабатывает событие |
OnAutoFormatApplied(DesignerAutoFormat) |
Вызывается после применения схемы автоматического форматирования к сопоставленному элементу управления. (Унаследовано от BaseDataListDesigner) |
OnBehaviorAttached() |
Устаревшие..
Позволяет запускать дополнительную обработку при вложении поведения в конструктор. (Унаследовано от TemplatedControlDesigner) |
OnBehaviorDetaching() |
Устаревшие..
Вызывается при разрыве связи поведения и элемента. (Унаследовано от HtmlControlDesigner) |
OnBindingsCollectionChanged(String) |
Устаревшие..
Вызывается при изменении коллекции привязки данных. (Унаследовано от ControlDesigner) |
OnClick(DesignerRegionMouseEventArgs) |
Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
OnColumnsChanged() |
Вызывается при изменении столбцов шаблона. |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Вызывается при наличии изменений в сопоставленном элементе управления. (Унаследовано от BaseDataListDesigner) |
OnComponentChanging(Object, ComponentChangingEventArgs) |
Предоставляет метод, обрабатывающий событие ComponentChanging для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
OnControlResize() |
Устаревшие..
Вызывается, когда изменяется размер сопоставленного серверного веб-элемента управления в основном приложении разработки во время разработки. (Унаследовано от ControlDesigner) |
OnDataSourceChanged() |
Вызывается при изменении источника данных для сопоставленного элемента управления. (Унаследовано от BaseDataListDesigner) |
OnPaint(PaintEventArgs) |
Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является |
OnPropertyBuilder(Object, EventArgs) |
Представляет метод, который обрабатывает событие построителя свойств. (Унаследовано от BaseDataListDesigner) |
OnSchemaRefreshed() |
Вызывается при изменении схемы источника данных для связанного элемента управления. (Унаследовано от BaseDataListDesigner) |
OnSetComponentDefaults() |
Устаревшие..
Устаревшие..
Задает для компонента свойства по умолчанию. (Унаследовано от ComponentDesigner) |
OnSetParent() |
Позволяет выполнять дополнительную обработку при изменении родителя конструктора. (Унаследовано от TemplatedControlDesigner) |
OnStylesChanged() |
Может быть переопределен для реализации функциональности, используемой при изменении стиля сопоставленного элемента управления. (Унаследовано от BaseDataListDesigner) |
OnTemplateEditingVerbsChanged() |
Вызывается при изменении команд редактирования шаблона. |
OnTemplateModeChanged() |
Позволяет выполнять дополнительную обработку при изменении режима шаблона. (Унаследовано от TemplatedControlDesigner) |
PostFilterAttributes(IDictionary) |
Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner) |
PostFilterEvents(IDictionary) |
Позволяет конструктору изменять или удалять элементы из набора событий, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner) |
PostFilterProperties(IDictionary) |
Позволяет конструктору изменять или удалять элементы из набора свойств, предоставленных с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner) |
PreFilterAttributes(IDictionary) |
Позволяет конструктору добавлять элементы к набору атрибутов, предоставленному с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner) |
PreFilterEvents(IDictionary) |
Определяет список событий, предоставляемых во время разработки для объекта TypeDescriptor компонента. (Унаследовано от HtmlControlDesigner) |
PreFilterProperties(IDictionary) |
Используется в конструкторе для добавления дополнительных свойств в сетку Свойства или удаления их оттуда, а также для затемнения свойств связанного элемента управления. (Унаследовано от BaseDataListDesigner) |
RaiseComponentChanged(MemberDescriptor, Object, Object) |
Уведомляет службу IComponentChangeService о том, что данный компонент был изменен. (Унаследовано от ComponentDesigner) |
RaiseComponentChanging(MemberDescriptor) |
Уведомляет службу IComponentChangeService о том, что компонент будет изменен. (Унаследовано от ComponentDesigner) |
RaiseResizeEvent() |
Устаревшие..
Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner) |
RegisterClone(Object, Object) |
Регистрирует внутренние данные в клонированном элементе управления. (Унаследовано от ControlDesigner) |
SaveActiveTemplateEditingFrame() |
Сохраняет активный фрейм редактирования шаблона. (Унаследовано от TemplatedControlDesigner) |
SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner) |
SetRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner) |
SetTemplateContent(ITemplateEditingFrame, String, String) |
Устаревшие..
Задает содержимое шаблона для указанного шаблона и кадра. |
SetViewFlags(ViewFlags, Boolean) |
Назначает указанное битовое перечисление ViewFlags указанному значению флага. (Унаследовано от ControlDesigner) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
UpdateDesignTimeHtml() |
Обновляет HTML-код времени разработки. (Унаследовано от TemplatedControlDesigner) |