HyperLinkDesigner 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.
Fornece suporte em tempo de design em um designer visual para o controle do HyperLink servidor Web.
public ref class HyperLinkDesigner : System::Web::UI::Design::TextControlDesignerpublic class HyperLinkDesigner : System.Web.UI.Design.TextControlDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class HyperLinkDesigner : System.Web.UI.Design.TextControlDesignertype HyperLinkDesigner = class
inherit TextControlDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type HyperLinkDesigner = class
inherit TextControlDesignerPublic Class HyperLinkDesigner
Inherits TextControlDesigner- Herança
- Atributos
Exemplos
Esta seção contém dois exemplos de código. O primeiro demonstra como derivar uma classe da HyperLinkDesigner classe, substituir um método e fornecer um valor de propriedade. O segundo demonstra como derivar um controle do HyperLink controle e aplicar um atributo no controle derivado.
O exemplo de código a seguir mostra como derivar uma CustomHyperLinkDesigner classe da HyperLinkDesigner classe. Ele substitui o GetDesignTimeHtml método para fornecer um valor padrão para a Text propriedade se o valor original for Text uma cadeia de caracteres vazia (""). Isso garante que o controle associado fique visível no momento do design.
// Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
public class CustomHyperLinkDesigner : HyperLinkDesigner
{
// Override the GetDesignTimeHtml to set the CustomHyperLink Text
// property so that it displays at design time.
public override string GetDesignTimeHtml()
{
CustomHyperLink hype = (CustomHyperLink)Component;
string designTimeMarkup = null;
// Save the original Text and note if it is empty.
string text = hype.Text;
bool noText = (text.Trim().Length == 0);
try
{
// If the Text is empty, supply a default value.
if (noText)
hype.Text = "Click here.";
// Call the base method to generate the markup.
designTimeMarkup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
// If an error occurs, generate the markup for an error message.
designTimeMarkup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the original value of the Text, if necessary.
if (noText)
hype.Text = text;
}
// If the markup is empty, generate the markup for a placeholder.
if(designTimeMarkup == null || designTimeMarkup.Length == 0)
designTimeMarkup = GetEmptyDesignTimeHtml();
return designTimeMarkup;
} // GetDesignTimeHtml
} // CustomHyperLinkDesigner
' Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
Public Class CustomHyperLinkDesigner
Inherits HyperLinkDesigner
' Override the GetDesignTimeHtml to set the CustomHyperLink Text
' property so that it displays at design time.
Public Overrides Function GetDesignTimeHtml() As String
Dim hype As CustomHyperLink = CType(Component, CustomHyperLink)
Dim designTimeMarkup As String = Nothing
' Save the original Text and note if it is empty.
Dim text As String = hype.Text
Dim noText As Boolean = (text.Trim().Length = 0)
Try
' If the Text is empty, supply a default value.
If noText Then
hype.Text = "Click here."
End If
' Call the base method to generate the markup.
designTimeMarkup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
' If an error occurs, generate the markup for an error message.
designTimeMarkup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the original value of the Text, if necessary.
If noText Then
hype.Text = text
End If
End Try
' If the markup is empty, generate the markup for a placeholder.
If ((designTimeMarkup = Nothing) Or _
(designTimeMarkup.Length = 0)) Then
designTimeMarkup = GetEmptyDesignTimeHtml()
End If
Return designTimeMarkup
End Function ' GetDesignTimeHtml
End Class
O exemplo de código a seguir mostra como derivar o CustomHyperLink controle do HyperLink controle e aplicar um DesignerAttribute atributo no CustomHyperLink controle para associá-lo ao CustomHyperLinkDesigner.
using System.Web;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The CustomHyperLink is a copy of the HyperLink.
// It uses the CustomHyperLinkDesigner for design-time support.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
CustomHyperLinkDesigner))]
public class CustomHyperLink : HyperLink
{
} // CustomHyperLink
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The CustomHyperLink is a copy of the HyperLink.
' It uses the CustomHyperLinkDesigner for design-time support.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
CustomHyperLinkDesigner))> _
Public Class CustomHyperLink
Inherits HyperLink
End Class
End Namespace ' Examples.VB.WebControls.Design
Comentários
O HyperLink controle cria um link para que o navegador do cliente navegue até outra página da Web.
Em um designer visual, quando você alterna do modo De origem para design, o código-fonte de marcação que descreve um HyperLink controle é analisado e uma versão em tempo de design do controle é criada na superfície de design. Quando você alterna de volta para o modo de exibição de origem, o controle de tempo de design é mantido para o código-fonte de marcação e editado na marcação da página da Web. A HyperLinkDesigner classe fornece suporte de tempo de design para o HyperLink controle.
O GetDesignTimeHtml método retorna a marcação usada para renderizar o controle associado HyperLink em tempo de design. O OnComponentChanged método é chamado quando há uma alteração no controle associado.
Construtores
| Nome | Description |
|---|---|
| HyperLinkDesigner() |
Inicializa uma nova instância da classe HyperLinkDesigner. |
Propriedades
| Nome | Description |
|---|---|
| ActionLists |
Obtém a coleção de lista de ações 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ática predefinidos a serem exibidos na caixa de diálogo Formato Automático para o controle associado em 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 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 a associação de dados tem suporte pela região que contém o controle associado. (Herdado de ControlDesigner) |
| DesignerState |
Obtém um objeto usado para persistir dados para o controle associado em tempo de design. (Herdado de ControlDesigner) |
| 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 |
Obsoleto.
Obtém um valor que indica se o host de design deve concluir o carregamento antes que o GetDesignTimeHtml método possa 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 estão ocultas quando o controle está no modo de modelo. (Herdado de ControlDesigner) |
| 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 |
Obtém um valor que indica se o controle está no modo de exibição ou edição de modelo no host de design. A InTemplateMode propriedade é somente leitura. (Herdado de ControlDesigner) |
| 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 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ária para gerar a marcação HTML em tempo de design. (Herdado de ControlDesigner) |
| Verbs |
Obtém os verbos de tempo de design compatíveis com o 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 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) |
| 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 que são usados pelo HtmlControlDesigner objeto e, opcionalmente, libera os recursos gerenciados. (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 esse local. (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, conforme exibido na superfície de design. (Herdado de ControlDesigner) |
| GetDesignTimeHtml() |
Obtém a marcação usada para renderizar o controle associado 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() |
Recupera a marcação HTML para representar um controle 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 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 a ser mantida para as marcas internas do controle. (Herdado de TextControlDesigner) |
| GetService(Type) |
Tenta recuperar o tipo de serviço especificado do site de 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 para o conteúdo e as regiões do controle associado. (Herdado de ControlDesigner) |
| Initialize(IComponent) |
Inicializa o designer com o componente especificado. (Herdado de TextControlDesigner) |
| 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á 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) |
| 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) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chamado quando um esquema de formatação automática predefinido foi aplicado ao controle associado. (Herdado de ControlDesigner) |
| OnBehaviorAttached() |
Chamado quando o designer de controle é anexado a um objeto Behavior. (Herdado de ControlDesigner) |
| 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) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chamado quando há uma alteração no controle associado. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chamado quando o controle associado é alterado. (Herdado de ControlDesigner) |
| 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) |
| OnPaint(PaintEventArgs) |
Chamado quando o designer de controle desenha o controle associado na superfície de design, se o CustomPaint valor for |
| OnSetComponentDefaults() |
Obsoleto.
Obsoleto.
Define as propriedades padrão do componente. (Herdado de ComponentDesigner) |
| OnSetParent() |
Fornece uma maneira de executar 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 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) |
Adiciona ou remove propriedades da grade Propriedades em um host de design em tempo de design ou fornece novas propriedades de tempo de design que podem corresponder às propriedades no controle associado. (Herdado de ControlDesigner) |
| 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) |
| 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) |
| 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 a marcação HTML em tempo de design para o controle de servidor Web associado chamando o GetDesignTimeHtml método. (Herdado de ControlDesigner) |
