ObjectDataSourceDesigner Classe

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 ObjectDataSource 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 a seguir mostra como estender a ObjectDataSourceDesigner classe para alterar a aparência e o comportamento dos controles derivados do ObjectDataSource controle em tempo de design.

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

Substitui MyObjectDataSourceDesigner o PreFilterProperties método para tornar a NamingContainer propriedade visível na grade Propriedades em tempo de design.

Substitui MyObjectDataSourceDesigner o GetDesignTimeHtml método para exibir as propriedades e SelectMethod as TypeName propriedades em um espaço reservado, além do tipo de controle e da 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

Comentários

O ObjectDataSource controle representa uma fonte de dados que chama métodos de um objeto de negócios para executar as operações Excluir, Inserir, Selecionar e Atualizar banco de dados.

Em um designer visual, quando você alterna do modo de origem para design, o código-fonte de marcação que descreve o ObjectDataSource controle é analisado e uma versão em tempo de design do controle é 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 é mantido para o código-fonte de marcação e editado na marcação da página da Web. A ObjectDataSourceDesigner classe fornece suporte de tempo de design para o ObjectDataSource controle em um 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 controle associado ObjectDataSource pode ser atualizado em tempo de design.
A SelectMethod propriedade especifica o método que executa a função Select. A TypeName propriedade especifica o tipo do objeto de negócios que fornece os dados para o controle associado.
O GetView método retorna uma exibição de fonte de dados com o nome especificado. O GetViewNames método retorna uma lista de nomes de exibição da fonte de dados para o controle associado ObjectDataSource . O RefreshSchema método extrai os metadados do método Select do objeto de negócios 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 controle associado.

Construtores

Nome	Description
ObjectDataSourceDesigner()	Inicializa uma nova instância da classe ObjectDataSourceDesigner.

Propriedades

Nome	Description
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 Configure() método pode ser chamado.
CanRefreshSchema	Obtém um valor que indica se o RefreshSchema(Boolean) método pode ser chamado.
Component	Obtém o componente que este designer está projetando. (Herdado de ComponentDesigner)
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)
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 HtmlControlDesigner objeto 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 GetDesignTimeHtml método 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)
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 InTemplateMode propriedade é 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)
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)
SelectMethod	Obtém ou define o nome do método a ser executado quando o Select() método do controle associado é chamado.
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 DataSourceChanged evento ou o RefreshSchema(Boolean) método 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)
TypeName	Obtém ou define o nome do tipo que contém os métodos especificados no controle associado.
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 `View` controle 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

Nome	Description
Configure()	Exibe o assistente Configurar Fonte de Dados na superfície do designer visual.
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)
CreateViewControl()	Retorna uma cópia do controle associado para exibição ou renderização na superfície de design. (Herdado de ControlDesigner)
Dispose()	Libera todos os recursos usados pelo ComponentDesigner. (Herdado de ComponentDesigner)
Dispose(Boolean)	Libera os recursos não gerenciados que são usados pelo HtmlControlDesigner objeto 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)
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)	Retorna uma exibição de fonte de dados com o nome especificado.
GetViewNames()	Retorna uma lista de nomes de exibição da fonte de dados para o controle associado.
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)
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 da especificada ComponentDesigner. (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)
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 ComponentChanging evento 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 DataSourceChanged evento quando as propriedades da fonte de dados são alteradas e o SuppressingDataSourceEvents valor é `false`. (Herdado de DataSourceDesigner)
OnPaint(PaintEventArgs)	Chamado quando o designer de controle desenha o controle associado na superfície de design, se o CustomPaint valor for `true`. (Herdado de ControlDesigner)
OnSchemaRefreshed(EventArgs)	Gera o SchemaRefreshed evento quando o esquema da fonte de dados é alterado e o SuppressingDataSourceEvents valor é `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 TypeDescriptor objeto do componente. (Herdado de HtmlControlDesigner)
PreFilterProperties(IDictionary)	Usado pelo designer para remover propriedades ou adicionar propriedades adicionais à exibição na grade Propriedades ou a propriedades de sombra do controle associado.
RaiseComponentChanged(MemberDescriptor, Object, Object)	Notifica que IComponentChangeService esse componente foi alterado. (Herdado de ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Notifica que IComponentChangeService esse componente está prestes a ser alterado. (Herdado de ComponentDesigner)
RaiseResizeEvent()	Obsoleto. Aciona o evento OnControlResize(). (Herdado de ControlDesigner)
RefreshSchema(Boolean)	Extrai os metadados do método Select do objeto de negócios especificado pelo controle associado.
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 bit a ViewFlags bit especificada ao valor do sinalizador especificado. (Herdado de ControlDesigner)
SuppressDataSourceEvents()	Adia todos os eventos da fonte de dados até que o ResumeDataSourceEvents() método 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 GetDesignTimeHtml método. (Herdado de ControlDesigner)

Eventos

Nome	Description
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

Nome	Description
IDesignerFilter.PostFilterAttributes(IDictionary)	Para obter uma descrição desse membro, consulte o PostFilterAttributes(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Para obter uma descrição desse membro, consulte o PostFilterEvents(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Para obter uma descrição desse membro, consulte o PostFilterProperties(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Para obter uma descrição desse membro, consulte o PreFilterAttributes(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Para obter uma descrição desse membro, consulte o PreFilterEvents(IDictionary) método. (Herdado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Para obter uma descrição desse membro, consulte o PreFilterProperties(IDictionary) método. (Herdado de ComponentDesigner)
ITreeDesigner.Children	Para obter uma descrição desse membro, consulte a Children propriedade. (Herdado de ComponentDesigner)
ITreeDesigner.Parent	Para obter uma descrição desse membro, consulte a Parent propriedade. (Herdado de ComponentDesigner)

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Compartilhar via

ObjectDataSourceDesigner 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