TableDesigner Classe

Referência

Definição

Namespace:: System.Web.UI.Design.WebControls

Assembly:: System.Design.dll

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 Table.

public ref class TableDesigner : System::Web::UI::Design::ControlDesigner

public class TableDesigner : System.Web.UI.Design.ControlDesigner

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class TableDesigner : System.Web.UI.Design.ControlDesigner

type TableDesigner = class
    inherit ControlDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type TableDesigner = class
    inherit ControlDesigner

Public Class TableDesigner
Inherits ControlDesigner

Herança: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
TableDesigner

Atributos: SupportsPreviewControlAttribute

Exemplos

A seção contém dois exemplos de código. O primeiro exemplo de código demonstra como derivar uma classe da TableDesigner classe . O segundo exemplo de código demonstra como exibir a StyledTable classe em tempo de design.

O exemplo de código a seguir demonstra como criar uma classe de designer chamada StyledTableDesigner, que é derivada da TableDesigner classe e é usada para exibir duas células em tempo de design para uma classe derivada da Table classe .

' Create a class, named StyledTableDesigner,
' that derives from the TableDesigner class.
' This class displays a class named StyledTable
' at design time.
Public Class StyledTableDesigner
   Inherits TableDesigner
   
   ' Override the GetDesignTimeHtml method to display
   ' placeholder text at design time for the 
   ' rows and cells of the StyledTable class.
   Public Overrides Function GetDesignTimeHtml() As String
       Dim sTable As StyledTable = CType(Component, StyledTable)
       Dim designTimeHTML As String
       Dim rows As TableRowCollection = sTable.Rows
       Dim cellsWithDummyContents As ArrayList = Nothing
      
       Dim emptyTable As Boolean = rows.Count = 0
       Dim emptyRows As Boolean = False
       Dim counter As Integer = 1
       Dim numcells As Integer = 2
       
       Try     
           ' Create two cells to display
           ' in a row at design time.
           If emptyTable Then
               Dim row As TableRow = New TableRow()
               rows.Add(row)
         
               Dim i As Integer
               For i = 0 To numcells - 1
                   Dim c As TableCell = New TableCell()
                   c.Text = "Cell #" & counter.ToString()
                   counter += 1
                   rows(0).Cells.Add(c)
               Next i
           Else
               emptyRows = True
               Dim j As Integer
               For j = 0 To rows.Count - 1
                   If rows(j).Cells.Count <> 0 Then
                       emptyRows = False
                       Exit For
                   End If
               Next j
               If emptyRows = True Then
                   Dim k As Integer
                   For k = 0 To numcells - 1
                       Dim c As TableCell = New TableCell()
                       c.Text = "Cell #" & counter.ToString()
                       counter += 1
                       rows(0).Cells.Add(c)
                   Next k
                End If
           End If
      
           If emptyTable = False Then
               ' If the rows and cells were defined by the user, but the
               ' cells remain empty this code defines a string to display 
               ' in them at design time.
               Dim row As TableRow
               For Each row In rows
                   Dim c As TableCell
                   For Each c In row.Cells
                       If ((c.Text.Length = 0) AndAlso (c.HasControls() = False)) Then
                          If cellsWithDummyContents Is Nothing Then
                              cellsWithDummyContents = New ArrayList()
                          End If
                          cellsWithDummyContents.Add(c)
                          c.Text = "Cell #" & counter.ToString()
                          counter += 1
                       End If
                   Next c
               Next row
           End If
           ' Retrieve the design-time HTML for the StyledTable class.
           designTimeHTML = MyBase.GetDesignTimeHtml()

       Finally
           ' If the StyledTable was empty before the dummy text was added,
           ' restore it to that state.
           If emptyTable Then
               rows.Clear()
           Else
               ' Clear the cells that were empty before the dummy text 
               ' was added.
               If Not (cellsWithDummyContents Is Nothing) Then
                   Dim c As TableCell
                   For Each c In  cellsWithDummyContents
                       c.Text = [String].Empty
                   Next c
               End If
               If emptyRows Then
                   rows(0).Cells.Clear()
               End If
           End If
      
       End Try
       Return designTimeHTML
   End Function

End Class

O exemplo de código a seguir usa o DesignerAttribute para associar a StyledTableDesigner classe à StyledTable classe para que ela possa ser exibida em tempo de design.

 ' Create a class that uses the StyledTableDesigner
 ' class to display its contents at design time.
<Designer("Examples.AspNet.Design.StyledTableDesigner", "TableDesigner")> _
Public Class StyledTable
  Inherits Table 
    

    Private tableStyle As Style = New Style()
    
    Public Sub New()
       tableStyle.BackColor = Color.LightBlue
       tableStyle.BorderColor = Color.Black
       
       CellSpacing = 4
       CellPadding = 0
       GridLines = GridLines.None
       BorderWidth = Unit.Point(1)
       Width = Unit.Percentage(100)
       Height = Unit.Percentage(100)

    End Sub
End Class

Construtores

TableDesigner()

Inicializa uma nova instância da classe TableDesigner.

Propriedades

ActionLists	Obtém a coleção de listas de ação do designer de controle. (Herdado de ControlDesigner)
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 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)
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 a associação de dados tem suporte da região que contém o controle associado. (Herdado de ControlDesigner)
DesignerState	Obtém um objeto usado para persistir os dados do controle associado em tempo de design. (Herdado de ControlDesigner)
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	Obsoleto. Obtém um valor que indica se o host de design deve concluir o carregamento antes do método GetDesignTimeHtml poder ser chamado. (Herdado de ControlDesigner)
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 associado são ocultadas quando o controle está no modo de modelo. (Herdado de ControlDesigner)
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	Obtém um valor que indica se o controle está em exibição de modelo ou em modo de edição no host de design. A propriedade InTemplateMode é somente leitura. (Herdado de ControlDesigner)
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 Table. (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 ou mais definições de modelo. (Herdado de ControlDesigner)
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 os verbos de tempo de design com suporte pelo componente associado ao designer. (Herdado de ComponentDesigner)
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 `View` foi criado para exibição na superfície de design. (Herdado de ControlDesigner)
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)
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 HtmlControlDesigner e libera opcionalmente os recursos gerados. (Herdado de HtmlControlDesigner)
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)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBounds()	Recupera as coordenadas do retângulo que representa os limites do controle como exibido na superfície de design. (Herdado de ControlDesigner)
GetDesignTimeHtml()	Obtém o HTML usado para representar o 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 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()	Recupera a marcação HTML para representar um controle de servidor Web em tempo de design que não terá uma representação visual em tempo de execução. (Herdado de ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Recupera a marcação HTML que fornece informações sobre a exceção especificada. (Herdado de ControlDesigner)
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()	Este membro substitui GetPersistInnerHtml().
GetPersistInnerHtml()	Obsoleto. Recupera a marcação HTML interna persistente do controle. (Herdado de ControlDesigner)
GetService(Type)	Tenta recuperar o tipo de serviço especificado do site no modo de design do componente do designer. (Herdado de ComponentDesigner)
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 de controle e carrega o componente especificado. (Herdado de ControlDesigner)
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)
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)
OnAutoFormatApplied(DesignerAutoFormat)	Chamado quando um esquema de formatação automática predefinido é aplicado ao controle associado. (Herdado de ControlDesigner)
OnBehaviorAttached()	Chamado quando o designer de controle está anexado a um objeto Behavior. (Herdado de ControlDesigner)
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)
OnComponentChanged(Object, ComponentChangedEventArgs)	Chamado quando há uma alteração no controle associado. (Herdado de ControlDesigner)
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)
OnPaint(PaintEventArgs)	Chamado quando o designer de controle desenha o controle associado na superfície de design, se o valor CustomPaint for `true`. (Herdado de ControlDesigner)
OnSetComponentDefaults()	Obsoleto. Obsoleto. Define as propriedades padrão do componente. (Herdado de ComponentDesigner)
OnSetParent()	Fornece uma maneira de realizar processamento adicional quando o controle associado é anexado a um controle pai. (Herdado de HtmlControlDesigner)
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)	Adiciona ou remove propriedades da grade de Propriedades em um host de design em tempo de design ou fornece novas propriedades de tempo de design que podem corresponder às propriedades do controle associado. (Herdado de ControlDesigner)
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)
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)
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 a marcação HTML de tempo de design do controle de servidor Web associado ao chamar o método GetDesignTimeHtml. (Herdado de ControlDesigner)

Implantações explícitas de interface

IDesignerFilter.PostFilterAttributes(IDictionary)	Para obter uma descrição desse membro, consulte o método PostFilterAttributes(IDictionary). (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Para obter uma descrição desse membro, consulte o método PostFilterEvents(IDictionary). (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Para obter uma descrição desse membro, consulte o método PostFilterProperties(IDictionary). (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Para obter uma descrição desse membro, consulte o método PreFilterAttributes(IDictionary). (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Para obter uma descrição desse membro, consulte o método PreFilterEvents(IDictionary). (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Para obter uma descrição desse membro, consulte o método PreFilterProperties(IDictionary). (Herdado de ComponentDesigner)
ITreeDesigner.Children	Para obter uma descrição desse membro, consulte o propriedade Children. (Herdado de ComponentDesigner)
ITreeDesigner.Parent	Para obter uma descrição desse membro, consulte o propriedade Parent. (Herdado de ComponentDesigner)

Aplica-se a

Confira também

Table