BaseValidatorDesigner 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.
Fornece suporte em tempo de design num designer visual para controlos de servidores Web derivados da BaseValidator classe.
public ref class BaseValidatorDesigner : System::Web::UI::Design::ControlDesignerpublic ref class BaseValidatorDesigner : System::Web::UI::Design::WebControls::PreviewControlDesignerpublic class BaseValidatorDesigner : System.Web.UI.Design.ControlDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class BaseValidatorDesigner : System.Web.UI.Design.WebControls.PreviewControlDesignertype BaseValidatorDesigner = class
inherit ControlDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type BaseValidatorDesigner = class
inherit PreviewControlDesignerPublic Class BaseValidatorDesigner
Inherits ControlDesignerPublic Class BaseValidatorDesigner
Inherits PreviewControlDesigner- Herança
- Herança
-
BaseValidatorDesigner
- Atributos
Exemplos
O exemplo seguinte deriva o SimpleCompareValidator controlo a partir da CompareValidator classe.
SimpleCompareValidator é uma cópia do CompareValidator. O exemplo também deriva o designer SimpleCompareValidatorDesigner a partir da BaseValidatorDesigner classe e usa o DesignerAttribute atributo para associar a SimpleCompareValidatorDesigner classe ao SimpleCompareValidator controlo.
SimpleCompareValidatorDesigner sobrepõe-se ao GetDesignTimeHtml método para desenhar uma borda sólida em torno do SimpleCompareValidator controlo no momento do projeto se o valor da BorderStyle propriedade do controlo for o NotSet campo ou None .
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The SimpleCompareValidator is a copy of the CompareValidator.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
SimpleCompareValidatorDesigner))]
public class SimpleCompareValidator : CompareValidator
{
} // SimpleCompareValidator
// Derive a designer that inherits from the BaseValidatorDesigner.
public class SimpleCompareValidatorDesigner : BaseValidatorDesigner
{
// Make the full extent of the control more visible in the designer.
// If the border style is None or NotSet, change the border to a
// solid line.
public override string GetDesignTimeHtml()
{
// Get a reference to the control or a copy of the control.
SimpleCompareValidator myCV = (SimpleCompareValidator)ViewControl;
string markup = null;
// Check if the border style should be changed.
if (myCV.BorderStyle == BorderStyle.NotSet ||
myCV.BorderStyle == BorderStyle.None)
{
// Save the current property setting.
BorderStyle oldBorderStyle = myCV.BorderStyle;
// Set the design-time property and catch any exceptions.
try
{
myCV.BorderStyle = BorderStyle.Solid;
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
markup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the property to its original setting.
myCV.BorderStyle = oldBorderStyle;
}
}
else
{
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
return markup;
} // GetDesignTimeHtml
} // SimpleCompareValidatorDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The SimpleCompareValidator is a copy of the CompareValidator.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
SimpleCompareValidatorDesigner))> _
Public Class SimpleCompareValidator
Inherits CompareValidator
End Class
' Derive a designer that inherits from the BaseValidatorDesigner.
Public Class SimpleCompareValidatorDesigner
Inherits BaseValidatorDesigner
' Make the full extent of the control more visible in the designer.
' If the border style is None or NotSet, change the border to a
' solid line.
Public Overrides Function GetDesignTimeHtml() As String
' Get a reference to the control or a copy of the control.
Dim myCV As SimpleCompareValidator = _
CType(ViewControl, SimpleCompareValidator)
Dim markup As String
' Check if the border style should be changed.
If (myCV.BorderStyle = BorderStyle.NotSet Or _
myCV.BorderStyle = BorderStyle.None) Then
' Save the current property setting.
Dim oldBorderStyle As BorderStyle = myCV.BorderStyle
' Set the design-time property and catch any exceptions.
Try
myCV.BorderStyle = BorderStyle.Solid
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
markup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the property to its original setting.
myCV.BorderStyle = oldBorderStyle
End Try
Else
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
End If
Return markup
End Function
End Class
End Namespace ' Examples.VB.WebControls.Design
Observações
Num designer visual, ao mudar da vista Source para a vista Design, o código-fonte de marcação que descreve um controlo derivado da BaseValidator classe abstrata é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando volta para a vista Fonte, o controlo de tempo de design é mantido para marcar o código-fonte e ser editado na marcação da página Web. Os BaseValidatorDesigner objetos fornecem suporte em tempo de design para controlos derivados da BaseValidator classe num designer visual.
O GetDesignTimeHtml método recebe a marcação que é usada para renderizar o controlo associado no momento do design.
Construtores
| Name | Description |
|---|---|
| BaseValidatorDesigner() |
Inicializa uma nova instância da BaseValidatorDesigner classe. |
Propriedades
| Name | Description |
|---|---|
| ActionLists |
Obtém a coleção da lista de ações para o designer de controlos. (Herdado de ControlDesigner) |
| 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 a coleção de esquemas automáticos de formatação pré-definidos para ser exibida na caixa de diálogo Formato Automático para o controlo associado no momento do design. (Herdado de ControlDesigner) |
| Behavior |
Obsoleto.
Obtém ou define o comportamento DHTML associado ao designer. (Herdado de HtmlControlDesigner) |
| 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 |
Obtém um valor que indica se a ligação de dados é suportada pela região que contém o controlo associado. (Herdado de ControlDesigner) |
| DesignerState |
Obtém um objeto que é usado para persistir dados para o controlo associado no momento do projeto. (Herdado de ControlDesigner) |
| 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 |
Obsoleto.
Recebe um valor que indica se o host de design deve terminar o carregamento antes de o GetDesignTimeHtml método poder ser chamado. (Herdado de ControlDesigner) |
| 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 associado estão ocultas quando o controlo está em modo template. (Herdado de ControlDesigner) |
| 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 |
Recebe um valor que indica se o controlo está em modo visualização de templates ou edição no host de design. A InTemplateMode propriedade é apenas de leitura. (Herdado de ControlDesigner) |
| 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 modelos, cada um contendo uma ou mais definições de modelos. (Herdado de ControlDesigner) |
| 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 PreviewControlDesigner) |
| Verbs |
Obtém os verbos em tempo de design suportados pelo componente associado ao designer. (Herdado de ComponentDesigner) |
| 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) |
| CreateViewControl() |
Retorna uma cópia do controlo associado para renderizar na superfície de design. |
| 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 que são usados pelo HtmlControlDesigner objeto e, opcionalmente, liberta os recursos geridos. (Herdado de HtmlControlDesigner) |
| 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) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBounds() |
Recupera as coordenadas do retângulo que representam os limites do controlo conforme exibido na superfície de design. (Herdado de ControlDesigner) |
| GetDesignTimeHtml() |
Obtém a marcação que é usada para renderizar o controlo associado 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() |
Recupera a marcação HTML para representar um controlo de servidor Web em tempo de design que não terá 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 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() |
Obsoleto.
Recupera a marcação HTML interna persistente do controlo. (Herdado de ControlDesigner) |
| 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) |
| 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 de controlo 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.
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) |
| 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) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chamado quando um esquema de formatação automático pré-definido foi aplicado ao controlo associado. (Herdado de ControlDesigner) |
| OnBehaviorAttached() |
Chamado quando o designer de controlos está associado a um objeto de Comportamento. (Herdado de ControlDesigner) |
| 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) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chamada quando o controlo associado muda. (Herdado de ControlDesigner) |
| 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) |
| OnPaint(PaintEventArgs) |
Chamado quando o projetista de controlo desenha o controlo associado na superfície de projeto, se o CustomPaint valor for |
| OnSetComponentDefaults() |
Obsoleto.
Define as propriedades padrão do componente. (Herdado de ComponentDesigner) |
| OnSetParent() |
Proporciona uma forma de realizar processamento adicional quando o controlo associado está associado a um controlo parental. (Herdado de HtmlControlDesigner) |
| 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 projetista para remover ou adicionar propriedades na grelha de propriedades, ou para sombrear propriedades do controlo associado. |
| PreFilterProperties(IDictionary) |
Adiciona propriedades ou remove propriedades da grelha de Propriedades num host de projeto no momento do projeto ou fornece novas propriedades em tempo de projeto que possam corresponder a propriedades no controlo associado. (Herdado de ControlDesigner) |
| 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) |
| 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) |
| 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 a marcação HTML em tempo de design para o controlo associado do servidor Web chamando o GetDesignTimeHtml método. (Herdado de ControlDesigner) |