ObjectDataSourceDesigner Classe

Definição

Espaço de Nomes:: System.Web.UI.Design.WebControls

Assemblagem:: System.Design.dll

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 ObjectDataSource controlo do servidor Web.

public ref class ObjectDataSourceDesigner : System::Web::UI::Design::DataSourceDesigner

public class ObjectDataSourceDesigner : System.Web.UI.Design.DataSourceDesigner

type ObjectDataSourceDesigner = class
    inherit DataSourceDesigner

Public Class ObjectDataSourceDesigner
Inherits DataSourceDesigner

Herança: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

DataSourceDesigner
ObjectDataSourceDesigner

Exemplos

O exemplo de código seguinte mostra como estender a ObjectDataSourceDesigner classe para alterar a aparência e o comportamento dos controlos derivados do ObjectDataSource controlo no momento do design.

O exemplo deriva o MyObjectDataSource controlo a partir do ObjectDataSource. É MyObjectDataSource uma cópia do ObjectDataSource controlo. O exemplo também deriva a MyObjectDataSourceDesigner classe de e ObjectDataSourceDesigner aplica um DesignerAttribute atributo para o MyObjectDataSourceDesigner sobre o MyObjectDataSource controlo.

Sobrepõe-se MyObjectDataSourceDesigner ao PreFilterProperties método para tornar a NamingContainer propriedade visível na grelha de Propriedades no momento do projeto.

O MyObjectDataSourceDesigner método substitui o GetDesignTimeHtml método para mostrar as TypeName propriedades e SelectMethod num marcador de lugar, além do tipo de controlo e do ID.

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The MyObjectDataSource is a copy of the ObjectDataSource.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.
        MyObjectDataSourceDesigner))]
    public class MyObjectDataSource : ObjectDataSource
    {
    } // MyObjectDataSource

    // Derive a designer that inherits from the ObjectDataSourceDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyObjectDataSourceDesigner : ObjectDataSourceDesigner
    {
        // Generate the design-time markup.
        public override string GetDesignTimeHtml()
        {
            // Get a reference to the control or a copy of the control.
            MyObjectDataSource myODS = (MyObjectDataSource)ViewControl;

            // Create a placeholder that displays the type of the business 
            // object and the name of the Select method.
            string markup = CreatePlaceHolderDesignTimeHtml(
                 "<b>TypeName</b> \"" + myODS.TypeName + "\"<br />" + 
                 "<b>SelectMethod</b> \"" + myODS.SelectMethod + "\"" );

            return markup;
        } // GetDesignTimeHtml

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

            // Make the NamingContainer visible in the Properties grid.
            PropertyDescriptor selectProp =
                (PropertyDescriptor)properties["NamingContainer"];
            properties["NamingContainer"] =
                TypeDescriptor.CreateProperty(selectProp.ComponentType,
                    selectProp, BrowsableAttribute.Yes);
        } // PreFilterProperties
    } // MyObjectDataSourceDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The MyObjectDataSource is a copy of the ObjectDataSource.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design. _
        MyObjectDataSourceDesigner))> _
    Public Class MyObjectDataSource
        Inherits ObjectDataSource
    End Class

    ' Derive a designer that inherits from the ObjectDataSourceDesigner.
    <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
    Public Class MyObjectDataSourceDesigner
        Inherits ObjectDataSourceDesigner

        ' Generate the design-time markup.
        Public Overrides Function GetDesignTimeHtml() As String

            ' Get a reference to the control or a copy of the control.
            Dim myODS As MyObjectDataSource = _
                CType(ViewControl, MyObjectDataSource)

            Dim markup As String = _
                CreatePlaceHolderDesignTimeHtml( _
                    "<b>TypeName</b> """ & myODS.TypeName & """<br />" & _
                    "<b>SelectMethod</b> """ & myODS.SelectMethod & """")

            Return markup

        End Function ' GetDesignTimeHtml

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

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

            ' Make the NamingContainer visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties("NamingContainer"), PropertyDescriptor)
            properties("NamingContainer") = _
                TypeDescriptor.CreateProperty(selectProp.ComponentType, _
                    selectProp, BrowsableAttribute.Yes)
        End Sub

    End Class
End Namespace ' Examples.VB.WebControls.Design

Observações

O ObjectDataSource controlo representa uma fonte de dados que chama métodos de um objeto de negócio para realizar as operações de Eliminar, Inserir, Selecionar e Atualizar a base de dados.

Num designer visual, quando se muda da vista de Fonte para a vista de Design, o código-fonte de marcação que descreve o ObjectDataSource controlo é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando regressa à vista Source, o controlo de tempo de design é mantido no código-fonte da marcação e editado na marcação da página Web. A ObjectDataSourceDesigner classe fornece suporte em tempo de design para o ObjectDataSource controlo num designer visual.

Os ObjectDataSourceDesigner membros da classe fornecem a seguinte funcionalidade:

A CanConfigure propriedade indica se o assistente Configurar Fonte de Dados pode ser exibido. A CanRefreshSchema propriedade indica se o esquema do controlo associado ObjectDataSource pode ser atualizado no momento do projeto.
A SelectMethod propriedade especifica o método que executa a função Select. A TypeName propriedade especifica o tipo do objeto de negócio que fornece os dados para o controlo associado.
O GetView método devolve uma vista de fonte de dados com o nome especificado. O GetViewNames método devolve uma lista de nomes de visualização de fontes de dados para o controlo associado ObjectDataSource . O RefreshSchema método extrai os metadados do método Select do objeto de negócio associado.
O Configure método faz com que o assistente Configurar Fonte de Dados seja exibido na superfície do designer visual. O PreFilterProperties método remove propriedades de, adiciona propriedades adicionais ou sombreia propriedades do controlo associado.

Construtores

Name	Description
ObjectDataSourceDesigner()	Inicializa uma nova instância da ObjectDataSourceDesigner 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.
CanRefreshSchema	Obtém um valor que indica se o RefreshSchema(Boolean) método pode ser chamado.
Component	Recebe o componente que este designer está a desenhar. (Herdado de ComponentDesigner)
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)
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)
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)
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)
SelectMethod	Recebe ou define o nome do método a executar quando o Select() método do controlo associado é chamado.
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)
TypeName	Recebe ou define o nome do tipo que contém os métodos especificados no controlo associado.
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 `View` controlo para exibição na superfície de design. (Herdado de ControlDesigner)
Visible	Obtém um valor que indica se o controlo é visível no momento do projeto. (Herdado de ControlDesigner)

Métodos

Name	Description
Configure()	Mostra o assistente Configurar Fonte de Dados na superfície do designer visual.
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)
CreateViewControl()	Devolve uma cópia do controlo associado para visualização ou renderização na superfície de design. (Herdado de ControlDesigner)
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)
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)	Devolve uma vista de fonte de dados com o nome especificado.
GetViewNames()	Devolve uma lista de nomes de vistas de fonte de dados para o controlo associado.
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)
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 é `false`. (Herdado de DataSourceDesigner)
OnPaint(PaintEventArgs)	Chamado quando o projetista de controlo desenha o controlo associado na superfície de projeto, se o CustomPaint valor for `true`. (Herdado de ControlDesigner)
OnSchemaRefreshed(EventArgs)	Aumenta o SchemaRefreshed evento quando o esquema da fonte de dados mudou e o SuppressingDataSourceEvents valor é `false`. (Herdado de DataSourceDesigner)
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 remover propriedades ou adicionar propriedades adicionais ao ecrã na grelha de Propriedades ou para sombrear 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)	Extrai os metadados do método Select do objeto de negócio especificado pelo controlo associado.
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)

Implementações de Interface Explícita

Name	Description
IDesignerFilter.PostFilterAttributes(IDictionary)	Para uma descrição deste elemento, veja o PostFilterAttributes(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Para uma descrição deste elemento, veja o PostFilterEvents(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Para uma descrição deste elemento, veja o PostFilterProperties(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Para uma descrição deste elemento, veja o PreFilterAttributes(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Para uma descrição deste elemento, veja o PreFilterEvents(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Para uma descrição deste elemento, veja o PreFilterProperties(IDictionary) método. (Herdado de ComponentDesigner)
ITreeDesigner.Children	Para uma descrição deste membro, veja a propriedade Children . (Herdado de ComponentDesigner)
ITreeDesigner.Parent	Para uma descrição deste membro, veja a propriedade Parent . (Herdado de ComponentDesigner)

Aplica-se a

Ver também

Comentários

Esta página foi útil?