DataGridDesigner Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Estende o comportamento de tempo de design para o controle do DataGrid servidor Web.
public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesignerpublic class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesignertype DataGridDesigner = class
inherit BaseDataListDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
inherit BaseDataListDesignerPublic Class DataGridDesigner
Inherits BaseDataListDesigner- Herança
- Atributos
Exemplos
O exemplo de código a seguir demonstra como estender a DataGridDesigner classe. O código substitui o GetDesignTimeHtml método para personalizar o CellPadding, BorderWidthe BorderColor as propriedades quando o DataGrid controle é renderizado em uma superfície de design.
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
O exemplo a seguir mostra como usar o DesignerAttribute atributo para associar o designer ao DataGrid controle.
' 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
Construtores
| Nome | Description |
|---|---|
| DataGridDesigner() |
Inicializa uma nova instância da classe DataGridDesigner. |
Propriedades
| Nome | Description |
|---|---|
| ActionLists |
Obtém a coleção de lista de ações do designer para este designer. (Herdado de BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
Obsoleto.
Obtém o quadro de edição de modelo ativo. (Herdado de TemplatedControlDesigner) |
| AllowResize |
Obtém um valor que indica se o controle pode ser redimensionado no ambiente de tempo de design. (Herdado de ControlDesigner) |
| AssociatedComponents |
Obtém a coleção de componentes associados ao componente gerenciado pelo designer. (Herdado de ComponentDesigner) |
| AutoFormats |
Obtém o DesignerAutoFormatCollection objeto associado a esse designer. |
| Behavior |
Obsoleto.
Obtém ou define o comportamento DHTML associado ao designer. (Herdado de HtmlControlDesigner) |
| CanEnterTemplateMode |
Obtém um valor que indica se esse designer permitirá ou não a exibição ou edição de modelos. (Herdado de TemplatedControlDesigner) |
| Component |
Obtém o componente que este designer está projetando. (Herdado de ComponentDesigner) |
| DataBindings |
Obtém a coleção de associações de dados para o controle atual. (Herdado de HtmlControlDesigner) |
| DataBindingsEnabled |
Obtém um valor que indica se o designer permite a associação de dados. (Herdado de TemplatedControlDesigner) |
| DataKeyField |
Obtém ou define o valor do campo de chave de dados do controle associado. (Herdado de BaseDataListDesigner) |
| DataMember |
Obtém ou define o valor do campo membro de dados do controle associado. (Herdado de BaseDataListDesigner) |
| DataSource |
Obtém ou define o valor da propriedade da fonte de dados do controle associado. (Herdado de BaseDataListDesigner) |
| DataSourceDesigner |
Obtém o designer da fonte de dados, quando um é selecionado para associação de dados. (Herdado de BaseDataListDesigner) |
| DataSourceID |
Obtém ou define a versão do designer da propriedade de ID da fonte de dados e é usada para sombrear a propriedade correspondente do controle associado. (Herdado de BaseDataListDesigner) |
| DesignerState |
Obtém um objeto usado para persistir dados para o controle associado em tempo de design. (Herdado de ControlDesigner) |
| DesignerView |
Obtém a exibição padrão da fonte de dados associada ao controle associado. (Herdado de BaseDataListDesigner) |
| DesignTimeElement |
Obsoleto.
Obtém o objeto de tempo de design que representa o controle associado ao HtmlControlDesigner objeto na superfície de design. (Herdado de HtmlControlDesigner) |
| DesignTimeElementView |
Obsoleto.
Obtém o objeto de controle de exibição para o designer de controle. (Herdado de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obtém um valor que indica se o carregamento deve ser concluído para exibir a marcação de tempo de design. (Herdado de BaseDataListDesigner) |
| Expressions |
Obtém as associações de expressão para o controle atual em tempo de design. (Herdado de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Obtém um valor que indica se as propriedades do controle serão ocultadas quando o controle for colocado no modo de edição de modelo. (Herdado de TemplatedControlDesigner) |
| ID |
Obtém ou define a cadeia de caracteres de ID para o controle. (Herdado de ControlDesigner) |
| InheritanceAttribute |
Obtém um atributo que indica o tipo de herança do componente associado. (Herdado de ComponentDesigner) |
| Inherited |
Obtém um valor que indica se esse componente é herdado. (Herdado de ComponentDesigner) |
| InTemplateMode |
Obsoleto.
Obtém um valor que indica se o documento do designer está no modo de modelo. (Herdado de TemplatedControlDesigner) |
| IsDirty |
Obsoleto.
Obtém ou define um valor que indica se o controle do servidor Web foi marcado como alterado. (Herdado de ControlDesigner) |
| ParentComponent |
Obtém o componente pai deste designer. (Herdado de ComponentDesigner) |
| ReadOnly |
Obsoleto.
Obtém ou define um valor que indica se as propriedades do controle são somente leitura no tempo de design. (Herdado de ControlDesigner) |
| RootDesigner |
Obtém o designer de controle da página Web Forms que contém o controle associado. (Herdado de ControlDesigner) |
| ShadowProperties |
Obtém uma coleção de valores de propriedade que substituem as configurações do usuário. (Herdado de ComponentDesigner) |
| ShouldCodeSerialize |
Obsoleto.
Obtém ou define um valor que indica se uma declaração de campo deve ser criada para o controle no arquivo code-behind do documento de design atual durante a serialização. (Herdado de HtmlControlDesigner) |
| Tag |
Obtém um objeto que representa o elemento de marcação HTML para o controle associado. (Herdado de ControlDesigner) |
| TemplateGroups |
Obtém uma coleção de grupos de modelos, cada um contendo uma definição de modelo. (Herdado de TemplatedControlDesigner) |
| UsePreviewControl |
Obtém um valor que indica se o designer de controle usa um controle de visualização temporária para gerar a marcação HTML em tempo de design. (Herdado de ControlDesigner) |
| Verbs |
Obtém a coleção de verbos disponíveis para este designer. (Herdado de BaseDataListDesigner) |
| ViewControl |
Obtém ou define um controle de servidor Web que pode ser usado para visualizar a marcação HTML em tempo de design. (Herdado de ControlDesigner) |
| ViewControlCreated |
Obtém ou define um valor que indica se um |
| Visible |
Obtém um valor que indica se o controle está visível no momento do design. (Herdado de ControlDesigner) |
Métodos
| Nome | Description |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Cria a marcação HTML para exibir uma mensagem de erro de exceção especificada em tempo de design. (Herdado de ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Cria a marcação HTML para exibir uma mensagem de erro especificada em tempo de design. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Fornece uma representação simples de espaço reservado retangular que exibe o tipo e a ID do controle. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fornece uma representação simples de espaço reservado retangular que exibe o tipo e a ID do controle e também instruções ou informações especificadas adicionais. (Herdado de ControlDesigner) |
| CreateTemplateEditingFrame(TemplateEditingVerb) |
Obsoleto.
Cria um quadro de edição de modelo usando o verbo especificado. |
| CreateViewControl() |
Retorna uma cópia do controle associado para exibição ou renderização na superfície de design. (Herdado de ControlDesigner) |
| Dispose() |
Libera todos os recursos usados pelo ComponentDesigner. (Herdado de ComponentDesigner) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DataGridDesigner objeto e, opcionalmente, libera os recursos gerenciados. |
| DoDefaultAction() |
Cria uma assinatura de método no arquivo de código-fonte para o evento padrão no componente e navega o cursor do usuário para esse local. (Herdado de ComponentDesigner) |
| EnterTemplateMode(ITemplateEditingFrame) |
Obsoleto.
Abre um objeto de quadro de modelo específico para edição no designer. (Herdado de TemplatedControlDesigner) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExitTemplateMode(Boolean, Boolean, Boolean) |
Obsoleto.
Fecha o quadro de edição de modelo atualmente ativo depois de salvar as alterações relevantes. (Herdado de TemplatedControlDesigner) |
| GetBounds() |
Recupera as coordenadas do retângulo que representa os limites do controle, conforme exibido na superfície de design. (Herdado de ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Obsoleto.
Obtém os verbos de edição de modelo em cache disponíveis para o designer. |
| GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Gera um objeto que pode ser usado como uma fonte de dados em tempo de design. (Herdado de BaseDataListDesigner) |
| GetDesignTimeDataSource(Int32, Boolean) |
Gera um objeto que pode ser usado como uma fonte de dados em tempo de design. (Herdado de BaseDataListDesigner) |
| GetDesignTimeHtml() |
Obtém a marcação HTML usada para representar o DataGrid controle em tempo de design. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera a marcação HTML para exibir o controle e preenche a coleção com as regiões atuais do designer de controle. (Herdado de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Retorna o conteúdo de uma região editável da exibição de tempo de design do controle associado. (Herdado de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Obtém a marcação HTML usada para representar um controle vazio baseado em modelo em tempo de design. |
| GetErrorDesignTimeHtml(Exception) |
Obtém a marcação HTML exibida em tempo de design para a exceção especificada quando um erro foi encontrado durante a renderização do controle. |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetPersistenceContent() |
Recupera a marcação HTML interna persistente do controle em tempo de design. (Herdado de ControlDesigner) |
| GetPersistInnerHtml() |
Obtém a marcação a ser mantida para o conteúdo que está no runtime de controle do servidor associado. (Herdado de TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Obtém o componente da fonte de dados do contêiner de controle associado, resolvido para um membro de dados específico. (Herdado de BaseDataListDesigner) |
| GetSelectedDataSource() |
Obtém o componente da fonte de dados do contêiner de controle associado. (Herdado de BaseDataListDesigner) |
| GetService(Type) |
Tenta recuperar o tipo de serviço especificado do site de modo de design do componente do designer. (Herdado de ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Obsoleto.
Obtém a propriedade do item de dados do contêiner de modelo. |
| GetTemplateContainerDataSource(String) |
Obsoleto.
Obtém a fonte de dados do contêiner do modelo. (Herdado de BaseDataListDesigner) |
| GetTemplateContent(ITemplateEditingFrame, String, Boolean) |
Obsoleto.
Obtém o conteúdo do modelo. |
| GetTemplateEditingVerbs() |
Obsoleto.
Obtém os verbos de edição de modelo disponíveis para o designer. (Herdado de TemplatedControlDesigner) |
| GetTemplateFromText(String) |
Cria um modelo com base no texto especificado. (Herdado de TemplatedControlDesigner) |
| GetTemplatePropertyParentType(String) |
Obsoleto.
Obtém o Type objeto correspondente ao pai do modelo especificado. |
| GetTextFromTemplate(ITemplate) |
Obtém uma cadeia de caracteres de texto que representa o modelo especificado. (Herdado de TemplatedControlDesigner) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetViewRendering() |
Recupera um objeto que contém a marcação de tempo de design para o conteúdo e as regiões do controle associado. (Herdado de ControlDesigner) |
| Initialize(IComponent) |
Inicializa o designer com o controle especificado DataGrid . |
| InitializeExistingComponent(IDictionary) |
Reinicializa um componente existente. (Herdado de ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inicializa um componente recém-criado. (Herdado de ComponentDesigner) |
| InitializeNonDefault() |
Obsoleto.
Inicializa as configurações de um componente importado que já está inicializado em configurações diferentes dos padrões. (Herdado de ComponentDesigner) |
| Invalidate() |
Invalida toda a área do controle exibida na superfície de design e sinaliza o designer de controle para redesenhar o controle. (Herdado de ControlDesigner) |
| Invalidate(Rectangle) |
Invalida a área especificada do controle que é exibida na superfície de design e sinaliza o designer de controle para redesenhar o controle. (Herdado de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtém o InheritanceAttribute da especificada ComponentDesigner. (Herdado de ComponentDesigner) |
| InvokePropertyBuilder(Int32) |
Invoca um editor de componentes para o controle associado. (Herdado de BaseDataListDesigner) |
| IsPropertyBound(String) |
Obsoleto.
Recupera um valor que indica se a propriedade especificada no controle associado está associada a dados. (Herdado de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Usa o gravador de recursos fornecido para manter as propriedades localizáveis do controle associado a um recurso no host de design. (Herdado de ControlDesigner) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnAutoFormat(Object, EventArgs) |
Obsoleto.
Manipula o |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chamado quando um esquema de formatação automática foi aplicado ao controle associado. (Herdado de BaseDataListDesigner) |
| OnBehaviorAttached() |
Obsoleto.
Oferece uma oportunidade para executar processamento adicional quando um comportamento é anexado ao designer. (Herdado de TemplatedControlDesigner) |
| OnBehaviorDetaching() |
Obsoleto.
Chamado quando um comportamento desassocia do elemento. (Herdado de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoleto.
Chamado quando a coleção de associação de dados é alterada. (Herdado de ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Chamado pelo host de design quando o usuário clica no controle associado em tempo de design. (Herdado de ControlDesigner) |
| OnColumnsChanged() |
Chamado quando as colunas do modelo são alteradas. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chamado quando há uma alteração no controle associado. (Herdado de BaseDataListDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representa o método que manipulará o ComponentChanging evento para o controle associado. (Herdado de ControlDesigner) |
| OnControlResize() |
Obsoleto.
Chamado quando o controle de servidor Web associado foi redimensionado no host de design em tempo de design. (Herdado de ControlDesigner) |
| OnDataSourceChanged() |
Chamado quando a fonte de dados do controle associado foi alterada. (Herdado de BaseDataListDesigner) |
| OnPaint(PaintEventArgs) |
Chamado quando o designer de controle desenha o controle associado na superfície de design, se o CustomPaint valor for |
| OnPropertyBuilder(Object, EventArgs) |
Representa o método que manipula o evento do construtor de propriedades. (Herdado de BaseDataListDesigner) |
| OnSchemaRefreshed() |
Chamado quando o esquema da fonte de dados para o controle associado é alterado. (Herdado de BaseDataListDesigner) |
| OnSetComponentDefaults() |
Obsoleto.
Define as propriedades padrão do componente. (Herdado de ComponentDesigner) |
| OnSetParent() |
Oferece uma oportunidade para executar processamento adicional quando o pai desse designer é alterado. (Herdado de TemplatedControlDesigner) |
| OnStylesChanged() |
Pode ser substituído para implementar a funcionalidade que deve ocorrer quando um estilo do controle associado for alterado. (Herdado de BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Chamado quando os verbos de edição de modelo são alterados. |
| OnTemplateModeChanged() |
Oferece uma oportunidade para executar processamento adicional quando o modo de modelo é alterado. (Herdado de TemplatedControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permite que um designer altere ou remova itens do conjunto de atributos que ele expõe por meio de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Permite que um designer altere ou remova itens do conjunto de eventos que ele expõe por meio de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Permite que um designer altere ou remova itens do conjunto de propriedades que ele expõe por meio de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permite que um designer adicione ao conjunto de atributos que ele expõe por meio de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Define a lista de eventos expostos em tempo de design para o TypeDescriptor objeto do componente. (Herdado de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Usado pelo designer para remover propriedades ou adicionar propriedades adicionais à exibição na grade Propriedades ou a propriedades de sombra do controle associado. (Herdado de BaseDataListDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica que IComponentChangeService esse componente foi alterado. (Herdado de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Notifica que IComponentChangeService esse componente está prestes a ser alterado. (Herdado de ComponentDesigner) |
| RaiseResizeEvent() |
Obsoleto.
Aciona o evento OnControlResize(). (Herdado de ControlDesigner) |
| RegisterClone(Object, Object) |
Registra dados internos em um controle clonado. (Herdado de ControlDesigner) |
| SaveActiveTemplateEditingFrame() |
Salva o quadro de edição de modelo ativo. (Herdado de TemplatedControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Especifica o conteúdo de uma região editável do controle em tempo de design. (Herdado de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Especifica o conteúdo de uma região editável no modo de exibição de tempo de design do controle. (Herdado de ControlDesigner) |
| SetTemplateContent(ITemplateEditingFrame, String, String) |
Obsoleto.
Define o conteúdo do modelo e quadro especificados. |
| SetViewFlags(ViewFlags, Boolean) |
Atribui a enumeração bit a ViewFlags bit especificada ao valor do sinalizador especificado. (Herdado de ControlDesigner) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| UpdateDesignTimeHtml() |
Atualiza o HTML de tempo de design. (Herdado de TemplatedControlDesigner) |