DataGridDesigner Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Prolonga o comportamento em tempo de projeto para o DataGrid controlo do 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 seguinte exemplo de código demonstra como estender a DataGridDesigner classe. O código sobrepõe-se ao GetDesignTimeHtml método para personalizar as CellPaddingpropriedades , BorderWidth, e BorderColor quando o DataGrid controlo é renderizado numa 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 seguinte mostra como usar o DesignerAttribute atributo para associar o designer ao DataGrid controlo.
' 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
| Name | Description |
|---|---|
| DataGridDesigner() |
Inicializa uma nova instância da DataGridDesigner classe. |
Propriedades
| Name | Description |
|---|---|
| ActionLists |
Obtém a coleção de listas de ações do designer para este designer. (Herdado de BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
Obsoleto.
Obtém o frame de edição do template ativo. (Herdado de TemplatedControlDesigner) |
| AllowResize |
Obtém um valor que indica se o controlo pode ser redimensionado no ambiente de design. (Herdado de ControlDesigner) |
| AssociatedComponents |
Obtém a coleção de componentes associados ao componente gerida pelo designer. (Herdado de ComponentDesigner) |
| AutoFormats |
Obtém o DesignerAutoFormatCollection objeto associado a este designer. |
| Behavior |
Obsoleto.
Obtém ou define o comportamento DHTML associado ao designer. (Herdado de HtmlControlDesigner) |
| CanEnterTemplateMode |
Recebe um valor que indica se este designer permitirá ou não a visualização ou edição de templates. (Herdado de TemplatedControlDesigner) |
| Component |
Recebe o componente que este designer está a desenhar. (Herdado de ComponentDesigner) |
| DataBindings |
Obtém a recolha de ligações de dados para o controlo atual. (Herdado de HtmlControlDesigner) |
| DataBindingsEnabled |
Recebe um valor que indica se o designer permite a ligação de dados. (Herdado de TemplatedControlDesigner) |
| DataKeyField |
Obtém ou define o valor do campo da chave de dados do controlo associado. (Herdado de BaseDataListDesigner) |
| DataMember |
Obtém ou define o valor do campo membro de dados do controlo associado. (Herdado de BaseDataListDesigner) |
| DataSource |
Obtém ou define o valor da propriedade da fonte de dados do controlo associado. (Herdado de BaseDataListDesigner) |
| DataSourceDesigner |
Obtém o designer da fonte de dados quando um é selecionado para ligação de dados. (Herdado de BaseDataListDesigner) |
| DataSourceID |
Obtém ou define a versão do designer da propriedade ID da fonte de dados e é usado para sombrear a propriedade correspondente do controlo associado. (Herdado de BaseDataListDesigner) |
| DesignerState |
Obtém um objeto que é usado para persistir dados para o controlo associado no momento do projeto. (Herdado de ControlDesigner) |
| DesignerView |
Obtém a vista padrão da fonte de dados que está ligada ao controlo associado. (Herdado de BaseDataListDesigner) |
| DesignTimeElement |
Obsoleto.
Obtém o objeto em tempo de design que representa o controlo associado ao HtmlControlDesigner objeto na superfície de projeto. (Herdado de HtmlControlDesigner) |
| DesignTimeElementView |
Obsoleto.
Obtém o objeto de view-control para o designer de controlo. (Herdado de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Recebe um valor que indica se o carregamento deve estar completo para mostrar a marcação de tempo de design. (Herdado de BaseDataListDesigner) |
| Expressions |
Obtém as associações de expressão para o controlo atual no momento do projeto. (Herdado de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Recebe um valor que indica se as propriedades do controlo estarão ocultas quando o controlo é colocado em modo de edição de templates. (Herdado de TemplatedControlDesigner) |
| ID |
Recebe ou define a cadeia ID do controlo. (Herdado de ControlDesigner) |
| InheritanceAttribute |
Obtém um atributo que indica o tipo de herança do componente associado. (Herdado de ComponentDesigner) |
| Inherited |
Recebe um valor que indica se este componente é herdado. (Herdado de ComponentDesigner) |
| InTemplateMode |
Obsoleto.
Recebe um valor que indica se o documento de designer está em modo modelo. (Herdado de TemplatedControlDesigner) |
| IsDirty |
Obsoleto.
Recebe ou define um valor que indica se o controlo do servidor Web foi marcado como alterado. (Herdado de ControlDesigner) |
| ParentComponent |
Obtém o componente pai para este designer. (Herdado de ComponentDesigner) |
| ReadOnly |
Obsoleto.
Recebe ou define um valor que indica se as propriedades do controlo são apenas leitura no momento do projeto. (Herdado de ControlDesigner) |
| RootDesigner |
Obtém o designer de controlos para a página Web Forms que contém o controlo associado. (Herdado de ControlDesigner) |
| ShadowProperties |
Obtém uma coleção de valores de propriedades que sobrepõem as definições do utilizador. (Herdado de ComponentDesigner) |
| ShouldCodeSerialize |
Obsoleto.
Recebe ou define um valor que indica se deve criar uma declaração de campo para o controlo no ficheiro 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 controlo associado. (Herdado de ControlDesigner) |
| TemplateGroups |
Obtém uma coleção de grupos de templates, cada um contendo uma definição de template. (Herdado de TemplatedControlDesigner) |
| UsePreviewControl |
Recebe um valor que indica se o designer de controlos usa um controlo de pré-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ível para este designer. (Herdado de BaseDataListDesigner) |
| ViewControl |
Obtém ou define um controlo de servidor Web que pode ser usado para pré-visualizar a marcação HTML em tempo de design. (Herdado de ControlDesigner) |
| ViewControlCreated |
Recebe ou define um valor que indica se foi criado um |
| Visible |
Obtém um valor que indica se o controlo é visível no momento do projeto. (Herdado de ControlDesigner) |
Métodos
| Name | Description |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Cria a marcação HTML para mostrar uma mensagem de erro de exceção especificada no momento do design. (Herdado de ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Cria marcação HTML para mostrar uma mensagem de erro especificada no momento do design. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Fornece uma representação simples retangular que mostra o tipo e o ID do controlo. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fornece uma representação simples retangular que mostra o tipo e o ID do controlo, bem como instruções ou informações adicionais especificadas. (Herdado de ControlDesigner) |
| CreateTemplateEditingFrame(TemplateEditingVerb) |
Obsoleto.
Cria um frame de edição de template usando o verbo especificado. |
| CreateViewControl() |
Devolve uma cópia do controlo associado para visualização ou renderização na superfície de design. (Herdado de ControlDesigner) |
| Dispose() |
Liberta todos os recursos utilizados pelo ComponentDesigner. (Herdado de ComponentDesigner) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo DataGridDesigner objeto e, opcionalmente, liberta os recursos geridos. |
| DoDefaultAction() |
Cria uma assinatura de método no ficheiro de código-fonte para o evento predefinido no componente e navega pelo cursor do utilizador até essa localização. (Herdado de ComponentDesigner) |
| EnterTemplateMode(ITemplateEditingFrame) |
Obsoleto.
Abre um determinado objeto frame template 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 frame de edição do template atualmente ativo após guardar quaisquer alterações relevantes. (Herdado de TemplatedControlDesigner) |
| GetBounds() |
Recupera as coordenadas do retângulo que representam os limites do controlo conforme exibido na superfície de design. (Herdado de ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Obsoleto.
Disponibiliza os verbos de edição do template em cache para o designer. |
| GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Gera um objeto que pode ser usado como fonte de dados no momento do projeto. (Herdado de BaseDataListDesigner) |
| GetDesignTimeDataSource(Int32, Boolean) |
Gera um objeto que pode ser usado como fonte de dados no momento do projeto. (Herdado de BaseDataListDesigner) |
| GetDesignTimeHtml() |
Obtém a marcação HTML usada para representar o DataGrid controlo no momento do design. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera a marcação HTML para mostrar o controlo e preenche a coleção com as regiões atuais do designer de controlo. (Herdado de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Devolve o conteúdo para uma região editável da vista em tempo de design do controlo associado. (Herdado de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Obtém a marcação HTML usada para representar um controlo vazio baseado em template no momento do design. |
| GetErrorDesignTimeHtml(Exception) |
Obtém a marcação HTML apresentada em tempo de design para a exceção especificada quando foi encontrado um erro durante a renderização do controlo. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetPersistenceContent() |
Recupera a marcação HTML interna persistente do controlo no momento do design. (Herdado de ControlDesigner) |
| GetPersistInnerHtml() |
Faz com que a marcação persista para o conteúdo que está no runtime de controlo do servidor associado. (Herdado de TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Obtém o componente fonte de dados do contentor de controlo associado, resolvido para um membro de dados específico. (Herdado de BaseDataListDesigner) |
| GetSelectedDataSource() |
Obtém o componente fonte de dados do contentor de controlo associado. (Herdado de BaseDataListDesigner) |
| GetService(Type) |
Tenta recuperar o tipo de serviço especificado a partir do local do modo de design do componente do projetista. (Herdado de ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Obsoleto.
Obtém a propriedade do elemento de dados do contentor modelo. |
| GetTemplateContainerDataSource(String) |
Obsoleto.
Obtém a fonte de dados do contentor do template. (Herdado de BaseDataListDesigner) |
| GetTemplateContent(ITemplateEditingFrame, String, Boolean) |
Obsoleto.
Percebe o conteúdo do modelo. |
| GetTemplateEditingVerbs() |
Obsoleto.
Disponibiliza os verbos de edição do modelo para o designer. (Herdado de TemplatedControlDesigner) |
| GetTemplateFromText(String) |
Cria um modelo a partir do texto especificado. (Herdado de TemplatedControlDesigner) |
| GetTemplatePropertyParentType(String) |
Obsoleto.
Obtém o Type objeto correspondente ao pai do template especificado. |
| GetTextFromTemplate(ITemplate) |
Recebe uma cadeia 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 em tempo de design para o conteúdo e regiões do controlo associado. (Herdado de ControlDesigner) |
| Initialize(IComponent) |
Inicializa o designer com o controlo 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 definições de um componente importado que já está inicializado para definições diferentes das predefinidas. (Herdado de ComponentDesigner) |
| Invalidate() |
Invalida toda a área do controlo que é exibida na superfície de projeto e sinaliza ao projetista do controlo para redesenhar o controlo. (Herdado de ControlDesigner) |
| Invalidate(Rectangle) |
Invalida a área especificada do controlo que é exibida na superfície de design e sinaliza ao projetista do controlo para redesenhar o controlo. (Herdado de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtém o InheritanceAttribute do especificado ComponentDesigner. (Herdado de ComponentDesigner) |
| InvokePropertyBuilder(Int32) |
Invoca um editor de componentes para o controlo associado. (Herdado de BaseDataListDesigner) |
| IsPropertyBound(String) |
Obsoleto.
Recupera um valor que indica se a propriedade especificada no controlo associado está ligada a dados. (Herdado de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Utiliza o escritor de recursos fornecido para persistir as propriedades localizáveis do controlo associado a um recurso no host de design. (Herdado de ControlDesigner) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnAutoFormat(Object, EventArgs) |
Obsoleto.
Trata do |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chamado quando um esquema de formatação automática foi aplicado ao controlo associado. (Herdado de BaseDataListDesigner) |
| OnBehaviorAttached() |
Obsoleto.
Proporciona a oportunidade de realizar processamento adicional quando um comportamento está associado ao designer. (Herdado de TemplatedControlDesigner) |
| OnBehaviorDetaching() |
Obsoleto.
Chamada quando um comportamento se dissocia do elemento. (Herdado de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoleto.
Chamada quando a coleção de ligação de dados muda. (Herdado de ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Chamada pelo anfitrião de design quando o utilizador clica no controlo associado no momento do design. (Herdado de ControlDesigner) |
| OnColumnsChanged() |
É chamado quando as colunas do modelo mudam. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chamada quando há uma alteração no controlo associado. (Herdado de BaseDataListDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representa o método que irá gerir o ComponentChanging evento para o controlo associado. (Herdado de ControlDesigner) |
| OnControlResize() |
Obsoleto.
Chamado quando o controlo do servidor Web associado foi redimensionado no host de design em tempo de design. (Herdado de ControlDesigner) |
| OnDataSourceChanged() |
Chamada quando a fonte de dados do controlo associado mudou. (Herdado de BaseDataListDesigner) |
| OnPaint(PaintEventArgs) |
Chamado quando o projetista de controlo desenha o controlo associado na superfície de projeto, se o CustomPaint valor for |
| OnPropertyBuilder(Object, EventArgs) |
Representa o método que gere o evento do construtor de propriedades. (Herdado de BaseDataListDesigner) |
| OnSchemaRefreshed() |
Chamado quando o esquema da fonte de dados para o controlo associado muda. (Herdado de BaseDataListDesigner) |
| OnSetComponentDefaults() |
Obsoleto.
Define as propriedades padrão do componente. (Herdado de ComponentDesigner) |
| OnSetParent() |
Proporciona uma oportunidade para realizar processamento adicional quando o pai deste designer é alterado. (Herdado de TemplatedControlDesigner) |
| OnStylesChanged() |
Pode ser anulado para implementar funcionalidades que deverão ocorrer quando um estilo do controlo associado mudou. (Herdado de BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Chamada quando os verbos de edição do template mudam. |
| OnTemplateModeChanged() |
Oferece a oportunidade de realizar processamento adicional quando o modo modelo é alterado. (Herdado de TemplatedControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permite a um designer alterar ou remover itens do conjunto de atributos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Permite a um designer alterar ou remover itens do conjunto de eventos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Permite a um designer alterar ou remover itens do conjunto de propriedades que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permite a um designer adicionar ao conjunto de atributos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Define a lista de eventos expostos no momento do design para o TypeDescriptor objeto do componente. (Herdado de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Usado pelo designer para remover propriedades ou adicionar propriedades adicionais ao ecrã na grelha de Propriedades ou para sombrear propriedades do controlo associado. (Herdado de BaseDataListDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica que IComponentChangeService este componente foi alterado. (Herdado de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Notifica que IComponentChangeService este componente está prestes a ser alterado. (Herdado de ComponentDesigner) |
| RaiseResizeEvent() |
Obsoleto.
Eleva o OnControlResize() evento. (Herdado de ControlDesigner) |
| RegisterClone(Object, Object) |
Regista dados internos num controlo clonado. (Herdado de ControlDesigner) |
| SaveActiveTemplateEditingFrame() |
Guarda o frame de edição do template ativo. (Herdado de TemplatedControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Especifica o conteúdo para uma região editável do controlo no momento do design. (Herdado de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Especifica o conteúdo de uma região editável na vista de design time do controlo. (Herdado de ControlDesigner) |
| SetTemplateContent(ITemplateEditingFrame, String, String) |
Obsoleto.
Define o conteúdo para o modelo e frame especificados. |
| SetViewFlags(ViewFlags, Boolean) |
Atribui a enumeração bit ViewFlags a bit especificada ao valor da bandeira especificado. (Herdado de ControlDesigner) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| UpdateDesignTimeHtml() |
Atualiza o HTML em tempo de design. (Herdado de TemplatedControlDesigner) |