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 de tempo de design em um designer visual para o controle de 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 AccessDataSourceDesigner classe. O segundo demonstra como derivar uma cópia da classe e associá-la a AccessDataSource um designer.

O exemplo de código a seguir demonstra como estender a AccessDataSourceDesigner classe. 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 AccessDataSource classe e associá-la ao designer que foi 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 da exibição De origem para design, o código-fonte de marcação que descreve o AccessDataSource controle é 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ê volta para o modo de exibição De origem, o controle de tempo de design, que inclui os valores das propriedades na grade Propriedades , é persistido 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á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)
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 deste designer está criando. (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 da 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 a consultas exclusão. (Herdado de SqlDataSourceDesigner)
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)
InsertQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte a consultas inserção. (Herdado de SqlDataSourceDesigner)
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)
ProviderName	Obtém ou define o nome do provedor de dados .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 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)
SelectCommand	Obtém ou define a consulta SQL no SqlDataSource associado para selecionar os dados do banco de dados subjacente. (Herdado de SqlDataSourceDesigner)
SelectQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte a consultas seleção. (Herdado de SqlDataSourceDesigner)
SetTextualDefaultProperty	Fornece suporte de tempo de design em um designer visual para o controle de 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 é 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)
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 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)
UpdateQuery	Obtém ou define o SqlDataSourceDesigner que dá suporte a consultas atualização. (Herdado de SqlDataSourceDesigner)
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

Configure()	Inicia o utilitário de configuração da fonte de dados no host de design. (Herdado de SqlDataSourceDesigner)
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)
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 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)
GetConnectionString()	Obtém a cadeia de conexão válida em tempo de design para o controle associado a este 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 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)
GetView(String)	Recupera um objeto DesignerDataSourceView que é identificado pelo nome de 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 do conteúdo e das 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á 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)
OnDataSourceChanged(EventArgs)	Aciona o evento DataSourceChanged quando as propriedades da fonte de dados foram alteradas e o valor de 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)	Aciona o evento SchemaRefreshed quando o esquema da fonte de dados foi alterado e o valor de SuppressingDataSourceEvents é `false`. (Herdado de DataSourceDesigner)
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)	Usada pelo designer para adicionar propriedades à grade Propriedades ou removê-las dela ou então para sombrear propriedades do controle associado.
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)
RefreshSchema(Boolean)	Atualiza o esquema da fonte de dados subjacente. (Herdado de SqlDataSourceDesigner)
RegisterClone(Object, Object)	Registra os dados internos em um controle clonado. (Herdado de ControlDesigner)
ResumeDataSourceEvents()	Restaura os eventos de fonte de dados depois que os eventos de fonte de dados foram 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 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)
SuppressDataSourceEvents()	Adia todos os eventos de fonte de dados até depois que o método ResumeDataSourceEvents() é chamado. (Herdado de DataSourceDesigner)
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)

Eventos

DataSourceChanged	Ocorre quando uma propriedade da fonte de dados associada é alterada. (Herdado de DataSourceDesigner)
SchemaRefreshed	Ocorre depois que o esquema foi 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 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

AccessDataSourceDesigner Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários

Recursos adicionais