ConnectionsZoneDesigner 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 no tempo de design para controles ConnectionsZone.
public ref class ConnectionsZoneDesigner : System::Web::UI::Design::WebControls::WebParts::ToolZoneDesignerpublic class ConnectionsZoneDesigner : System.Web.UI.Design.WebControls.WebParts.ToolZoneDesignertype ConnectionsZoneDesigner = class
inherit ToolZoneDesignerPublic Class ConnectionsZoneDesigner
Inherits ToolZoneDesigner- Herança
-
ConnectionsZoneDesigner
Exemplos
O exemplo de código a seguir mostra como ocultar propriedades adicionais de um controle personalizado ConnectionsZone substituindo o PreFilterProperties método .
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.Design.WebControls.WebParts;
using System.ComponentModel;
using System.Collections;
/// <summary>
/// ConnectionsZoneSample provides a blank inheritance of
/// the ConnectionsZone class for the purpose of attaching
/// a custom designer.
/// ConnectionsZoneSampleDesigner shows how to edit the
/// PreFilterProperties() method to hide a specific property
/// at design time.
/// </summary>
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(ConnectionsZoneSampleDesigner))]
public class ConnectionsZoneSample : ConnectionsZone {}
public class ConnectionsZoneSampleDesigner : ConnectionsZoneDesigner
{
// Here is the property we will hide.
string propertyToHide = "BackColor";
protected override void PreFilterProperties(IDictionary properties)
{
// Invoke the base method. This will hide those properties
// specified in ConnectionsZoneDesigner.
base.PreFilterProperties(properties);
// Set attributes to remove it from the property grid and any editors.
Attribute[] newAttributes = new Attribute[]
{ new BrowsableAttribute(false),
new EditorBrowsableAttribute(EditorBrowsableState.Never)};
PropertyDescriptor property = (PropertyDescriptor)properties[propertyToHide];
if (property != null)
{
// Re-create the property with the attributes specified above.
properties[propertyToHide] = TypeDescriptor.CreateProperty(property.ComponentType, property, newAttributes);
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.Design.WebControls.WebParts
Imports System.ComponentModel
Imports System.Collections
' ConnectionsZoneSample provides a blank inheritance of
' the ConnectionsZone class for the purpose of attaching
' a custom designer.
' ConnectionsZoneSampleDesigner shows how to edit the
' PreFilterProperties() method to hide a specific property
' at design time.
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(ConnectionsZoneSampleDesigner))> _
Public Class ConnectionsZoneSample
Inherits ConnectionsZone
End Class
Public Class ConnectionsZoneSampleDesigner
Inherits ConnectionsZoneDesigner
' Here is the property we will hide.
Private propertyToHide As String = "BackColor"
Protected Overrides Sub PreFilterProperties(properties As IDictionary)
' Invoke the base method. This will hide those properties
' specified in ConnectionsZoneDesigner.
MyBase.PreFilterProperties(properties)
' Set attributes to remove it from the property grid and any editors.
Dim newAttributes As Attribute() = New Attribute() {New BrowsableAttribute(False), New EditorBrowsableAttribute(EditorBrowsableState.Never)}
Dim [property] As PropertyDescriptor = DirectCast(properties(propertyToHide), PropertyDescriptor)
If [property] IsNot Nothing Then
' Re-create the property with the attributes specified above.
properties(propertyToHide) = TypeDescriptor.CreateProperty([property].ComponentType, [property], newAttributes)
End If
End Sub
End Class
End Namespace
Comentários
ConnectionsZoneDesigner fornece uma representação em tempo de design de um ConnectionsZone controle com um menu para acessar a AutoFormats coleção e a ViewInBrowseMode propriedade para a conveniência do desenvolvedor de páginas. É o único designer de zona que não dá suporte a regiões de designer. Isso ocorre porque ConnectionsZone os controles usam links para criar conexões em vez de uma interface do usuário (interface do usuário) do tipo "arrastar e soltar".
A AutoFormats coleção e a ViewInBrowseMode propriedade aparecem no menu de verbos do ConnectionsZone controle. AutoFormats, quando selecionado, fornece uma seleção de esquemas de cores. A ViewInBrowseMode caixa de seleção, quando selecionada, exibe o conteúdo do controle como ele apareceria no navegador; o controle ficará vazio até que uma conexão seja feita.
Você pode herdar de ConnectionsZoneDesigner para dar suporte a um controle personalizado ConnectionsZone como com qualquer outro designer de controle. Você pode substituir o GetDesignTimeHtml método para alterar a marcação que renderiza o controle. Você também pode substituir a AutoFormats coleção para adicionar um DesignerAutoFormatCollection com um esquema personalizado.
Construtores
| ConnectionsZoneDesigner() |
Inicializa uma nova instância da classe ConnectionsZoneDesigner. |
Propriedades
| ActionLists |
Obtém a coleção de lista de ação para o designer de zona. (Herdado de ToolZoneDesigner) |
| 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. |
| 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 |
Fornece suporte no tempo de design para controles ConnectionsZone. (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 deve usar uma cópia temporária em vez do controle real associado ao designer para gerar a marcação de tempo de design. (Herdado de WebZoneDesigner) |
| 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 |
| ViewInBrowseMode |
Obtém ou define um valor que indica se a zona de Web Parts é exibida quando o usuário está no modo de exibição de busca. (Herdado de ToolZoneDesigner) |
| 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 a marcação que é usada para representar o controle no 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() |
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) |
Associa o designer ao controle ConnectionsZone 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) |
| 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 |
| 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) |
Oculta um grupo de propriedades predefinido em tempo de design. |
| 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) |
