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

Fornece suporte em tempo de design em um designer visual para o controle do servidor Web AccessDataSource.

public ref class AccessDataSourceDesigner : System::Web::UI::Design::WebControls::SqlDataSourceDesigner

public class AccessDataSourceDesigner : System.Web.UI.Design.WebControls.SqlDataSourceDesigner

type AccessDataSourceDesigner = class
    inherit SqlDataSourceDesigner

Public Class AccessDataSourceDesigner
Inherits SqlDataSourceDesigner

Herança: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

DataSourceDesigner

SqlDataSourceDesigner
AccessDataSourceDesigner

Exemplos

Esta seção fornece dois exemplos de código. O primeiro demonstra como estender a classe AccessDataSourceDesigner. O segundo demonstra como derivar uma cópia da classe AccessDataSource e associá-la a um designer.

O exemplo de código a seguir demonstra como estender a classe AccessDataSourceDesigner. O código altera o espaço reservado que representa o controle na superfície de design e adiciona uma propriedade à grade Propriedades.

// Shadow control properties with design time properties.
protected override void PreFilterProperties(IDictionary properties)
{
    // Call the base class method first.
    base.PreFilterProperties(properties);

    // Add the ConnectionString property to the property grid.
    PropertyDescriptor property =
        (PropertyDescriptor)properties["ConnectionString"];
    Attribute[] attributes = new Attribute[]
    {
        new BrowsableAttribute(true),
        new ReadOnlyAttribute(true)
    };
    properties["ConnectionString"] = TypeDescriptor.CreateProperty(
        GetType(), property, attributes);
}

' Shadow control properties with design time properties.
Protected Overrides Sub PreFilterProperties(ByVal properties As IDictionary)

    ' Call the base class method first.
    MyBase.PreFilterProperties(properties)

    ' Add the ConnectionString property to the property grid.
    Dim prop As PropertyDescriptor
    prop = CType(properties("ConnectionString"), PropertyDescriptor)

   Dim atts(1) As Attribute
    atts(0) = New BrowsableAttribute(True)
    atts(1) = New ReadOnlyAttribute(True)

    properties("ConnectionString") = TypeDescriptor.CreateProperty( _
        prop.GetType(), prop, atts)
End Sub

O exemplo de código a seguir demonstra como derivar uma cópia da classe AccessDataSource e associá-la ao designer definido no exemplo anterior.

// Create a control and bind it to the ExampleAccessDataSourceDesigner.
[AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(CustomControls.Design.ExampleAccessDataSourceDesigner))]
public class ExampleAccessDataSource : AccessDataSource
{
    // Does nothing extra
}

' Create a control and bind it to the ExampleAccessDataSourceDesigner.
<AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand, _
    Level:=System.Web.AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, _
    Level:=System.Web.AspNetHostingPermissionLevel.Minimal)> _
<Designer("CustomControls.Design.ExampleAccessDataSourceDesigner")> _
Public Class ExampleAccessDataSource
    Inherits AccessDataSource

    ' Does nothing extra
End Class

Comentários

Em um designer visual, quando você alterna do modo de origem para design, o código-fonte de marcação que descreve o controle AccessDataSource é analisado e uma versão em tempo de design do controle, que é apenas um espaço reservado, é 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, que inclui os valores das propriedades na grade Propriedades do , é mantido no código-fonte de marcação e editado na marcação da página da Web.

Construtores

AccessDataSourceDesigner()

Inicializa uma nova instância da classe AccessDataSource.

Propriedades

ActionLists	Obtém uma lista de itens que são usados para criar um menu de lista de ações em tempo de design. (Herdado de DataSourceDesigner)
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)
CanConfigure	Obtém um valor que indica se o método Configure() pode ser chamado pelo host de design. (Herdado de SqlDataSourceDesigner)
CanRefreshSchema	Obtém um valor que indica se o método RefreshSchema(Boolean) pode ser chamado pelo host de design. (Herdado de SqlDataSourceDesigner)
Component	Obtém o componente que este designer está projetando. (Herdado de ComponentDesigner)
ConnectionString	Obtém ou define a cadeia de caracteres usada para abrir um banco de dados. (Herdado de SqlDataSourceDesigner)
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)
DataFile	Implementa uma propriedade de designer para sombrear a propriedade DataFile do controle associado.
DeleteQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte à exclusão de consultas. (Herdado de SqlDataSourceDesigner)
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 objeto HtmlControlDesigner 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 método GetDesignTimeHtml 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)
InsertQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte à inserção de consultas. (Herdado de SqlDataSourceDesigner)
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 propriedade InTemplateMode é 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)
ProviderName	Obtém ou define o nome do provedor de dados do .NET Framework que o controle SqlDataSource associado usa para se conectar a uma fonte de dados subjacente. (Herdado de SqlDataSourceDesigner)
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)
SelectCommand	Obtém ou define a consulta SQL no SqlDataSource associado para selecionar dados do banco de dados subjacente. (Herdado de SqlDataSourceDesigner)
SelectQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte a consultas selecionadas. (Herdado de SqlDataSourceDesigner)
SetTextualDefaultProperty	Fornece suporte em tempo de design em um designer visual para o controle do servidor Web AccessDataSource. (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 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)
SuppressingDataSourceEvents	Obtém um valor que indica se o evento DataSourceChanged ou o método RefreshSchema(Boolean) ocorre. (Herdado de DataSourceDesigner)
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)
UpdateQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte a consultas de atualização. (Herdado de SqlDataSourceDesigner)
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 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 no momento do design. (Herdado de ControlDesigner)

Métodos

Configure()	Inicia o utilitário de configuração da fonte de dados no host de design. (Herdado de SqlDataSourceDesigner)
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)
CreateView(String)	Cria uma nova instância de SqlDesignerDataSourceView usando o nome especificado. (Herdado de SqlDataSourceDesigner)
CreateViewControl()	Retorna uma cópia do controle associado para exibição ou renderização na superfície de design. (Herdado de ControlDesigner)
DeriveParameters(String, DbCommand)	Deriva os parâmetros do comando SQL especificado e adiciona objetos Parameter correspondentes à coleção de parâmetros do comando. (Herdado de SqlDataSourceDesigner)
Dispose()	Libera todos os recursos usados pelo ComponentDesigner. (Herdado de ComponentDesigner)
Dispose(Boolean)	Libera os recursos não gerenciados que são usados pelo objeto HtmlControlDesigner 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)
GetConnectionString()	Obtém a cadeia de conexão válida no momento do design para o controle associado a esse designer.
GetDesignTimeHtml()	Recupera a marcação HTML para exibir o controle de fonte de dados associado em tempo de design. (Herdado de DataSourceDesigner)
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()	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 de modo de design do componente do designer. (Herdado de ComponentDesigner)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetView(String)	Recupera um objeto DesignerDataSourceView identificado pelo nome da exibição. (Herdado de SqlDataSourceDesigner)
GetViewNames()	Obtém uma lista de exibições disponíveis. (Herdado de SqlDataSourceDesigner)
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)
InferParameterNames(DesignerDataConnection, String, SqlDataSourceCommandType)	Retorna uma matriz de parâmetros usando a conexão, o texto do comando e o tipo de comando especificados. (Herdado de SqlDataSourceDesigner)
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á 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 do ComponentDesignerespecificado. (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 o controle associado é alterado. (Herdado de ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Representa o método que manipulará o evento ComponentChanging 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)
OnDataSourceChanged(EventArgs)	Gera o evento DataSourceChanged quando as propriedades da fonte de dados são alteradas e o valor SuppressingDataSourceEvents é `false`. (Herdado de DataSourceDesigner)
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)
OnSchemaRefreshed(EventArgs)	Gera o evento SchemaRefreshed quando o esquema da fonte de dados é alterado e o valor SuppressingDataSourceEvents é `false`. (Herdado de DataSourceDesigner)
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 objeto TypeDescriptor do componente. (Herdado de HtmlControlDesigner)
PreFilterProperties(IDictionary)	Usado pelo designer para adicionar propriedades ou removê-las da grade Propriedades ou para as propriedades de sombra do controle associado.
RaiseComponentChanged(MemberDescriptor, Object, Object)	Notifica o IComponentChangeService de que esse componente foi alterado. (Herdado de ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Notifica o IComponentChangeService de que esse componente está prestes a ser alterado. (Herdado de ComponentDesigner)
RaiseResizeEvent()	Obsoleto. Gera o evento OnControlResize(). (Herdado de ControlDesigner)
RefreshSchema(Boolean)	Atualiza o esquema da fonte de dados subjacente. (Herdado de SqlDataSourceDesigner)
RegisterClone(Object, Object)	Registra dados internos em um controle clonado. (Herdado de ControlDesigner)
ResumeDataSourceEvents()	Restaura eventos de fonte de dados depois que os eventos da fonte de dados são suprimidos. (Herdado de DataSourceDesigner)
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 de ViewFlags bit a bit especificada ao valor do sinalizador especificado. (Herdado de ControlDesigner)
SuppressDataSourceEvents()	Adia todos os eventos da fonte de dados até que o método ResumeDataSourceEvents() seja chamado. (Herdado de DataSourceDesigner)
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 método GetDesignTimeHtml. (Herdado de ControlDesigner)

Eventos

DataSourceChanged	Ocorre quando qualquer propriedade da fonte de dados associada é alterada. (Herdado de DataSourceDesigner)
SchemaRefreshed	Ocorre depois que o esquema é atualizado. (Herdado de DataSourceDesigner)

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 a propriedade Children. (Herdado de ComponentDesigner)
ITreeDesigner.Parent	Para obter uma descrição desse membro, consulte a propriedade Parent. (Herdado de ComponentDesigner)

Aplica-se a

Compartilhar via