AccessDataSourceDesigner 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 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
-
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 |
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 é |
OnPaint(PaintEventArgs) |
Chamado quando o designer de controle desenha o controle associado na superfície de design, se o valor CustomPaint for |
OnSchemaRefreshed(EventArgs) |
Aciona o evento SchemaRefreshed quando o esquema da fonte de dados foi alterado e o valor de SuppressingDataSourceEvents é |
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) |