AccessDataSourceDesigner Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece suporte em tempo de design num designer visual para o AccessDataSource controlo do servidor Web.
public ref class AccessDataSourceDesigner : System::Web::UI::Design::WebControls::SqlDataSourceDesignerpublic class AccessDataSourceDesigner : System.Web.UI.Design.WebControls.SqlDataSourceDesignertype AccessDataSourceDesigner = class
inherit SqlDataSourceDesignerPublic Class AccessDataSourceDesigner
Inherits SqlDataSourceDesigner- Herança
-
AccessDataSourceDesigner
Exemplos
Esta secção fornece dois exemplos de código. O primeiro mostra como prolongar a AccessDataSourceDesigner aula. O segundo demonstra como derivar uma cópia da AccessDataSource classe e associá-la a um designer.
O seguinte exemplo de código demonstra como estender a AccessDataSourceDesigner classe. O código altera o marcador de posição que representa o controlo na superfície de design e adiciona uma propriedade à grelha de 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 seguinte exemplo de código demonstra como derivar uma cópia da AccessDataSource classe 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
Observações
Num designer visual, quando se muda da vista Source para a vista Design, o código-fonte de marcação que descreve o AccessDataSource controlo é analisado e uma versão em tempo de design do controlo, que é apenas um marcador de lugar, é criada na superfície do design. Quando volta para a vista de código-fonte, o controlo de tempo de design, que inclui os valores das propriedades na grelha de Propriedades , é mantido no código-fonte da marcação e editado na marcação da página Web.
Construtores
| Name | Description |
|---|---|
| AccessDataSourceDesigner() |
Inicializa uma nova instância da AccessDataSource classe. |
Propriedades
| Name | Description |
|---|---|
| ActionLists |
Recebe uma lista de itens que são usados para criar um menu de lista de ações na altura do design. (Herdado de DataSourceDesigner) |
| AllowResize |
Obtém um valor que indica se o controlo pode ser redimensionado no ambiente de design. (Herdado de ControlDesigner) |
| AssociatedComponents |
Obtém a coleção de componentes associados ao componente gerida pelo designer. (Herdado de ComponentDesigner) |
| AutoFormats |
Obtém a coleção de esquemas automáticos de formatação pré-definidos para ser exibida na caixa de diálogo Formato Automático para o controlo associado no momento do 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 Configure() método pode ser chamado pelo host de design. (Herdado de SqlDataSourceDesigner) |
| CanRefreshSchema |
Obtém um valor que indica se o RefreshSchema(Boolean) método pode ser chamado pelo host de design. (Herdado de SqlDataSourceDesigner) |
| Component |
Recebe o componente que este designer está a desenhar. (Herdado de ComponentDesigner) |
| ConnectionString |
Obtém ou define a cadeia usada para abrir uma base de dados. (Herdado de SqlDataSourceDesigner) |
| DataBindings |
Obtém a recolha de ligações de dados para o controlo atual. (Herdado de HtmlControlDesigner) |
| DataBindingsEnabled |
Obtém um valor que indica se a ligação de dados é suportada pela região que contém o controlo associado. (Herdado de ControlDesigner) |
| DataFile |
Implementa uma propriedade projetista para sombrear a DataFile propriedade do controlo associado. |
| DeleteQuery |
Obtém ou define o SqlDataSourceDesigner que suporta consultas de eliminação. (Herdado de SqlDataSourceDesigner) |
| DesignerState |
Obtém um objeto que é usado para persistir dados para o controlo associado no momento do projeto. (Herdado de ControlDesigner) |
| DesignTimeElement |
Obsoleto.
Obtém o objeto em tempo de design que representa o controlo associado ao HtmlControlDesigner objeto na superfície de projeto. (Herdado de HtmlControlDesigner) |
| DesignTimeElementView |
Obsoleto.
Obtém o objeto de view-control para o designer de controlo. (Herdado de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obsoleto.
Recebe um valor que indica se o host de design deve terminar o carregamento antes de o GetDesignTimeHtml método poder ser chamado. (Herdado de ControlDesigner) |
| Expressions |
Obtém as associações de expressão para o controlo atual no momento do projeto. (Herdado de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Recebe um valor que indica se as propriedades do controlo associado estão ocultas quando o controlo está em modo template. (Herdado de ControlDesigner) |
| ID |
Recebe ou define a cadeia ID do controlo. (Herdado de ControlDesigner) |
| InheritanceAttribute |
Obtém um atributo que indica o tipo de herança do componente associado. (Herdado de ComponentDesigner) |
| Inherited |
Recebe um valor que indica se este componente é herdado. (Herdado de ComponentDesigner) |
| InsertQuery |
Obtém ou define o SqlDataSourceDesigner que suporta inserção de consultas. (Herdado de SqlDataSourceDesigner) |
| InTemplateMode |
Recebe um valor que indica se o controlo está em modo visualização de templates ou edição no host de design. A InTemplateMode propriedade é apenas de leitura. (Herdado de ControlDesigner) |
| IsDirty |
Obsoleto.
Recebe ou define um valor que indica se o controlo do 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 fornecedor de dados .NET Framework que o controlo associado SqlDataSource utiliza para se ligar a uma fonte de dados subjacente. (Herdado de SqlDataSourceDesigner) |
| ReadOnly |
Obsoleto.
Recebe ou define um valor que indica se as propriedades do controlo são apenas leitura no momento do projeto. (Herdado de ControlDesigner) |
| RootDesigner |
Obtém o designer de controlos para a página Web Forms que contém o controlo associado. (Herdado de ControlDesigner) |
| SelectCommand |
Obtém ou define a consulta SQL na base associada SqlDataSource para selecionar dados da base de dados subjacente. (Herdado de SqlDataSourceDesigner) |
| SelectQuery |
Obtém ou define o SqlDataSourceDesigner que suporta consultas selecionadas. (Herdado de SqlDataSourceDesigner) |
| ShadowProperties |
Obtém uma coleção de valores de propriedades que sobrepõem as definições do utilizador. (Herdado de ComponentDesigner) |
| ShouldCodeSerialize |
Obsoleto.
Recebe ou define um valor que indica se deve criar uma declaração de campo para o controlo no ficheiro code-behind do documento de design atual durante a serialização. (Herdado de HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Recebe um valor que indica se o DataSourceChanged evento ou o RefreshSchema(Boolean) método ocorrem. (Herdado de DataSourceDesigner) |
| Tag |
Obtém um objeto que representa o elemento de marcação HTML para o controlo associado. (Herdado de ControlDesigner) |
| TemplateGroups |
Obtém uma coleção de grupos de modelos, cada um contendo uma ou mais definições de modelos. (Herdado de ControlDesigner) |
| UpdateQuery |
Obtém ou define o SqlDataSourceDesigner que suporta consultas de atualização. (Herdado de SqlDataSourceDesigner) |
| UsePreviewControl |
Recebe um valor que indica se o designer de controlos usa um controlo de pré-visualização temporária para gerar a marcação HTML em tempo de design. (Herdado de ControlDesigner) |
| Verbs |
Obtém os verbos em tempo de design suportados pelo componente associado ao designer. (Herdado de ComponentDesigner) |
| ViewControl |
Obtém ou define um controlo de servidor Web que pode ser usado para pré-visualizar a marcação HTML em tempo de design. (Herdado de ControlDesigner) |
| ViewControlCreated |
Recebe ou define um valor que indica se foi criado um |
| Visible |
Obtém um valor que indica se o controlo é visível no momento do projeto. (Herdado de ControlDesigner) |
Métodos
| Name | Description |
|---|---|
| Configure() |
Inicia a utilidade de configuração da fonte de dados no host de design. (Herdado de SqlDataSourceDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Cria a marcação HTML para mostrar uma mensagem de erro de exceção especificada no momento do design. (Herdado de ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Cria marcação HTML para mostrar uma mensagem de erro especificada no momento do design. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Fornece uma representação simples retangular que mostra o tipo e o ID do controlo. (Herdado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fornece uma representação simples retangular que mostra o tipo e o ID do controlo, bem como instruções ou informações adicionais especificadas. (Herdado de ControlDesigner) |
| CreateView(String) |
Cria uma nova SqlDesignerDataSourceView instância usando o nome especificado. (Herdado de SqlDataSourceDesigner) |
| CreateViewControl() |
Devolve uma cópia do controlo associado para visualização ou renderização na superfície de design. (Herdado de ControlDesigner) |
| DeriveParameters(String, DbCommand) |
Deriva os parâmetros a partir do comando SQL especificado e adiciona objetos correspondentes Parameter à coleção de parâmetros do comando. (Herdado de SqlDataSourceDesigner) |
| Dispose() |
Liberta todos os recursos utilizados pelo ComponentDesigner. (Herdado de ComponentDesigner) |
| Dispose(Boolean) |
Liberta os recursos não geridos que são usados pelo HtmlControlDesigner objeto e, opcionalmente, liberta os recursos geridos. (Herdado de HtmlControlDesigner) |
| DoDefaultAction() |
Cria uma assinatura de método no ficheiro de código-fonte para o evento predefinido no componente e navega pelo cursor do utilizador até 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 representam os limites do controlo conforme exibido na superfície de design. (Herdado de ControlDesigner) |
| GetConnectionString() |
Obtém a cadeia de ligação válida no momento do design para o controlo associado a este designer. |
| GetDesignTimeHtml() |
Recupera a marcação HTML para mostrar o controlo de fonte de dados associado no momento do design. (Herdado de DataSourceDesigner) |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera a marcação HTML para mostrar o controlo e preenche a coleção com as regiões atuais do designer de controlo. (Herdado de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Devolve o conteúdo para uma região editável da vista em tempo de design do controlo associado. (Herdado de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Recupera a marcação HTML para representar um controlo 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 função de hash predefinida. (Herdado de Object) |
| GetPersistenceContent() |
Recupera a marcação HTML interna persistente do controlo no momento do design. (Herdado de ControlDesigner) |
| GetPersistInnerHtml() |
Obsoleto.
Recupera a marcação HTML interna persistente do controlo. (Herdado de ControlDesigner) |
| GetService(Type) |
Tenta recuperar o tipo de serviço especificado a partir do local do modo de design do componente do projetista. (Herdado de ComponentDesigner) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetView(String) |
Recupera um DesignerDataSourceView objeto identificado pelo nome da visualização. (Herdado de SqlDataSourceDesigner) |
| GetViewNames() |
Obtém uma lista das visualizações disponíveis. (Herdado de SqlDataSourceDesigner) |
| GetViewRendering() |
Recupera um objeto que contém a marcação em tempo de design para o conteúdo e regiões do controlo associado. (Herdado de ControlDesigner) |
| InferParameterNames(DesignerDataConnection, String, SqlDataSourceCommandType) |
Devolve um array de parâmetros usando a ligação especificada, o texto do comando e o tipo de comando. (Herdado de SqlDataSourceDesigner) |
| Initialize(IComponent) |
Inicializa o designer de controlo 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 definições de um componente importado que já está inicializado para definições diferentes das predefinidas. (Herdado de ComponentDesigner) |
| Invalidate() |
Invalida toda a área do controlo que é exibida na superfície de projeto e sinaliza ao projetista do controlo para redesenhar o controlo. (Herdado de ControlDesigner) |
| Invalidate(Rectangle) |
Invalida a área especificada do controlo que é exibida na superfície de design e sinaliza ao projetista do controlo para redesenhar o controlo. (Herdado de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtém o InheritanceAttribute do especificado ComponentDesigner. (Herdado de ComponentDesigner) |
| IsPropertyBound(String) |
Obsoleto.
Recupera um valor que indica se a propriedade especificada no controlo associado está ligada a dados. (Herdado de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Utiliza o escritor de recursos fornecido para persistir as propriedades localizáveis do controlo associado a um recurso no host de design. (Herdado de ControlDesigner) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chamado quando um esquema de formatação automático pré-definido foi aplicado ao controlo associado. (Herdado de ControlDesigner) |
| OnBehaviorDetaching() |
Obsoleto.
Chamada quando um comportamento se dissocia do elemento. (Herdado de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoleto.
Chamada quando a coleção de ligação de dados muda. (Herdado de ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Chamada pelo anfitrião de design quando o utilizador clica no controlo associado no momento do design. (Herdado de ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chamada quando o controlo associado muda. (Herdado de ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representa o método que irá gerir o ComponentChanging evento para o controlo associado. (Herdado de ControlDesigner) |
| OnControlResize() |
Obsoleto.
Chamado quando o controlo do servidor Web associado foi redimensionado no host de design em tempo de design. (Herdado de ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
Aumenta o DataSourceChanged evento quando as propriedades da fonte de dados mudaram e o SuppressingDataSourceEvents valor é |
| OnPaint(PaintEventArgs) |
Chamado quando o projetista de controlo desenha o controlo associado na superfície de projeto, se o CustomPaint valor for |
| OnSchemaRefreshed(EventArgs) |
Aumenta o SchemaRefreshed evento quando o esquema da fonte de dados mudou e o SuppressingDataSourceEvents valor é |
| OnSetComponentDefaults() |
Obsoleto.
Obsoleto.
Define as propriedades padrão do componente. (Herdado de ComponentDesigner) |
| OnSetParent() |
Proporciona uma forma de realizar processamento adicional quando o controlo associado está associado a um controlo parental. (Herdado de HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permite a um designer alterar ou remover itens do conjunto de atributos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Permite a um designer alterar ou remover itens do conjunto de eventos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Permite a um designer alterar ou remover itens do conjunto de propriedades que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permite a um designer adicionar ao conjunto de atributos que expõe através de um TypeDescriptor. (Herdado de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Define a lista de eventos expostos no momento do design para o TypeDescriptor objeto do componente. (Herdado de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Usado pelo designer para adicionar propriedades ou removê-las da grelha de Propriedades ou para sombras de propriedades do controlo associado. |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica que IComponentChangeService este componente foi alterado. (Herdado de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Notifica que IComponentChangeService este componente está prestes a ser alterado. (Herdado de ComponentDesigner) |
| RaiseResizeEvent() |
Obsoleto.
Eleva o OnControlResize() evento. (Herdado de ControlDesigner) |
| RefreshSchema(Boolean) |
Atualiza o esquema a partir da fonte de dados subjacente. (Herdado de SqlDataSourceDesigner) |
| RegisterClone(Object, Object) |
Regista dados internos num controlo clonado. (Herdado de ControlDesigner) |
| ResumeDataSourceEvents() |
Restaura os eventos da fonte de dados depois de os eventos da fonte de dados terem sido suprimidos. (Herdado de DataSourceDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Especifica o conteúdo para uma região editável do controlo no momento do design. (Herdado de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Especifica o conteúdo de uma região editável na vista de design time do controlo. (Herdado de ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Atribui a enumeração bit ViewFlags a bit especificada ao valor da bandeira especificado. (Herdado de ControlDesigner) |
| SuppressDataSourceEvents() |
Adia todos os eventos da fonte de dados até depois de o ResumeDataSourceEvents() método ser chamado. (Herdado de DataSourceDesigner) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| UpdateDesignTimeHtml() |
Atualiza a marcação HTML em tempo de design para o controlo associado do servidor Web chamando o GetDesignTimeHtml método. (Herdado de ControlDesigner) |
evento
| Name | Description |
|---|---|
| DataSourceChanged |
Ocorre quando qualquer propriedade da fonte de dados associada muda. (Herdado de DataSourceDesigner) |
| SchemaRefreshed |
Ocorre depois de o esquema ter sido atualizado. (Herdado de DataSourceDesigner) |
