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 de servidor Web DataGrid.
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 as CellPaddingpropriedades , BorderWidthe BorderColor 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
| DataGridDesigner() |
Inicializa uma nova instância da classe DataGridDesigner. |
Propriedades
| ActionLists |
Obtém a coleção da lista de ação de designer para esse designer. (Herdado de BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
Obsoleto.
Obtém o quadro de edição de modelos ativos. (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 objeto DesignerAutoFormatCollection associado a esse designer. |
| AutoFormats |
Obtém a coleção de esquemas de formatação automáticos predefinidos para exibir na caixa de diálogo Autoformatação do controle associado no tempo de design. (Herdado de ControlDesigner) |
| 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 deste designer está criando. (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 habilita 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 de 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 da propriedade da ID da fonte de dados do designer e é usada para sombrear a propriedade correspondente do controle associado. (Herdado de BaseDataListDesigner) |
| DesignerState |
Obtém um objeto usado para persistir os dados do 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 em tempo de design que representa o controle associado ao objeto HtmlControlDesigner na superfície de design. (Herdado de HtmlControlDesigner) |
| DesignTimeElementView |
Obsoleto.
Obtém o objeto de controle de exibição do 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 da ID do 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 este componente é herdado. (Herdado de ComponentDesigner) |
| InTemplateMode |
Obsoleto.
Obtém um valor que indica se o documento de designer está no modo de modelo. (Herdado de TemplatedControlDesigner) |
| IsDirty |
Obsoleto.
Obtém ou define um valor que indica se o controle de servidor Web foi marcado como alterado. (Herdado de ControlDesigner) |
| ParentComponent |
Obtém o componente pai para este designer. (Herdado de ComponentDesigner) |
| ReadOnly |
Obsoleto.
Obtém ou define um valor que indica se as propriedades do controle são somente leitura em 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) |
| SetTextualDefaultProperty |
Estende o comportamento de tempo de design para o controle de servidor Web DataGrid. (Herdado de ComponentDesigner) |
| 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 é necessário criar uma declaração de campo para o controle no arquivo code-behind para o documento de design atual durante a serialização. (Herdado de HtmlControlDesigner) |
| Tag |
Obtém um objeto que representa o elemento de marcação HTML do controle associado. (Herdado de ControlDesigner) |
| TemplateGroups |
Obtém uma coleção de grupos de modelos, cada uma 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ário para gerar a marcação HTML de 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 de tempo de design. (Herdado de ControlDesigner) |
| ViewControlCreated |
Obtém ou define um valor que indica se um controle |
| Visible |
Obtém um valor que indica se o controle está visível em tempo de design. (Herdado de ControlDesigner) |
Métodos
| CreateErrorDesignTimeHtml(String) |
Cria uma marcação HTML para exibir uma mensagem de erro especificada em tempo de design. (Herdado de ControlDesigner) |
| 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) |
| CreatePlaceHolderDesignTimeHtml() |
Fornece uma representação de espaço reservado retangular simples que exibe o tipo e a ID do controle. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fornece uma representação de espaço reservado retangular simples que exibe o tipo e a ID do controle, bem como outras instruções ou informações especificadas. (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 objeto DataGridDesigner e libera opcionalmente 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 essa localização. (Herdado de ComponentDesigner) |
| EnterTemplateMode(ITemplateEditingFrame) |
Obsoleto.
Abre um 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 ativo atualmente após salvar quaisquer alterações relevantes. (Herdado de TemplatedControlDesigner) |
| GetBounds() |
Recupera as coordenadas do retângulo que representa os limites do controle como exibido na superfície de design. (Herdado de ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Obsoleto.
Obtém os verbos de edição de modelo armazenados 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 controle DataGrid em tempo de design. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera a marcação HTML para exibir o controle e preenche a coleção com as regiões de designer de controle atuais. (Herdado de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Retorna o conteúdo de uma região editável do modo de 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 ao renderizar o controle. |
| GetHashCode() |
Serve como a função de hash padrão. (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 para persistir o conteúdo que está no runtime de controle de servidor associado. (Herdado de TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Obtém o componente da fonte de dados do contêiner do 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 controles associados. (Herdado de BaseDataListDesigner) |
| GetService(Type) |
Tenta recuperar o tipo de serviço especificado do site no modo de design do componente do designer. (Herdado de ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Obsoleto.
Obtém a propriedade de 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 do texto especificado. (Herdado de TemplatedControlDesigner) |
| GetTemplatePropertyParentType(String) |
Obsoleto.
Obtém o objeto Type 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 do conteúdo e das regiões do controle associado. (Herdado de ControlDesigner) |
| Initialize(IComponent) |
Inicializa o designer com o controle DataGrid especificado. |
| InitializeExistingComponent(IDictionary) |
Reinicializa um componente existente. (Herdado de ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inicializa um componente recém-criado. (Herdado de ComponentDesigner) |
| InitializeNonDefault() |
Obsoleto.
Obsoleto.
Inicializa as configurações de um componente importado que já foi inicializado para as configurações que não sejam os padrões. (Herdado de ComponentDesigner) |
| Invalidate() |
Invalida toda a área do controle que é exibida na superfície de design e envia um sinal para o designer de controle redesenhar o controle. (Herdado de ControlDesigner) |
| Invalidate(Rectangle) |
Invalida a área especificada do controle que é exibida na superfície de design e envia um sinal para o designer de controle redesenhar o controle. (Herdado de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtém o InheritanceAttribute do ComponentDesigner especificado. (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 é associada a dados. (Herdado de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Usa o gravador de recurso fornecido para persistir as propriedades localizáveis do controle associado para um recurso no host de design. (Herdado de ControlDesigner) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnAutoFormat(Object, EventArgs) |
Obsoleto.
Manipula o evento |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chamado quando um esquema de formatação automática foi aplicado ao controle associado. (Herdado de BaseDataListDesigner) |
| OnBehaviorAttached() |
Obsoleto.
Fornece uma oportunidade para executar processamento adicional quando um comportamento está anexado ao designer. (Herdado de TemplatedControlDesigner) |
| OnBehaviorDetaching() |
Obsoleto.
Chamado quando um comportamento é desassociado 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 evento ComponentChanging de um controle associado. (Herdado de ControlDesigner) |
| OnControlResize() |
Obsoleto.
Chamado quando o controle de servidor Web associado é redimensionado no host de design em tempo de design. (Herdado de ControlDesigner) |
| OnDataSourceChanged() |
Chamado quando a fonte de dados do controle associado tiver sido alterada. (Herdado de BaseDataListDesigner) |
| OnPaint(PaintEventArgs) |
Chamado quando o designer de controle desenha o controle associado na superfície de design, se o valor CustomPaint for |
| OnPropertyBuilder(Object, EventArgs) |
Representa o método que manipula o evento do criador de propriedades. (Herdado de BaseDataListDesigner) |
| OnSchemaRefreshed() |
Chamado quando o esquema da fonte de dados do controle associado é alterado. (Herdado de BaseDataListDesigner) |
| OnSetComponentDefaults() |
Obsoleto.
Obsoleto.
Define as propriedades padrão do componente. (Herdado de ComponentDesigner) |
| OnSetParent() |
Fornece uma oportunidade para executar processamento adicional quando o pai deste designer é alterado. (Herdado de TemplatedControlDesigner) |
| OnStylesChanged() |
Pode ser substituído para implementar a funcionalidade que deve ocorrer quando um estilo do controle associado foi alterado. (Herdado de BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Chamado quando os verbos de edição de modelo são alterados. |
| OnTemplateModeChanged() |
Fornece 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 um designer seja adicionado ao conjunto de atributos que ele expõe por meio de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Define a lista de eventos que são expostos em tempo de design para o objeto TypeDescriptor para o componente. (Herdado de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Usado pelo designer para remover propriedades da exibição ou adicionar outras propriedades a ela na grade Propriedades ou para sombrear propriedades do controle associado. (Herdado de BaseDataListDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica o IComponentChangeService de que este componente foi alterado. (Herdado de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Notifica o IComponentChangeService de que este componente está prestes a ser alterado. (Herdado de ComponentDesigner) |
| RaiseResizeEvent() |
Obsoleto.
Aciona o evento OnControlResize(). (Herdado de ControlDesigner) |
| RegisterClone(Object, Object) |
Registra os dados internos em um controle clonado. (Herdado de ControlDesigner) |
| SaveActiveTemplateEditingFrame() |
Salva o quadro de edição de modelos 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 na exibição de tempo de design do controle. (Herdado de ControlDesigner) |
| SetTemplateContent(ITemplateEditingFrame, String, String) |
Obsoleto.
Define o conteúdo para o modelo e quadro especificados. |
| SetViewFlags(ViewFlags, Boolean) |
Atribui a enumeração ViewFlags bit a bit especificada ao valor de 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) |
