Partilhar via


DataSourceDesigner Classe

Definição

Fornece suporte de tempo de design em um host de design para a classe DataSourceControl.

public ref class DataSourceDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceDesigner
public class DataSourceDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceDesigner
type DataSourceDesigner = class
    inherit ControlDesigner
    interface IDataSourceDesigner
Public Class DataSourceDesigner
Inherits ControlDesigner
Implements IDataSourceDesigner
Herança
Derivado
Implementações

Exemplos

O exemplo de código a seguir mostra como usar um controle de fonte de dados personalizado com várias outras classes personalizadas pequenas, conforme listado na tabela a seguir.

Classe personalizada Derivado de
CustomDataSource ObjectDataSource
CustomDataSourceDesigner DataSourceDesigner
CustomDataSourceView ObjectDataSourceView
CustomDesignDataSourceView DesignerDataSourceView
BookListViewSchema IDataSourceViewSchema
CustomIDFieldSchema IDataSourceFieldSchema
CustomTitleFieldSchema IDataSourceFieldSchema
BookItem (Uma estrutura de dados de dois campos.)

Depois de compilar o exemplo de código, abra a página .aspx no modo Design e defina a DataSourceID propriedade como a ID do controle de fonte de dados personalizado.

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

namespace ASPNet.Design.Samples_CS
{
    [Designer(typeof(CustomDataSourceDesigner)),
        ToolboxData("<{0}:CustomDataSource runat=\"server\"></{0}:CustomDataSource>")]
    public class CustomDataSource : ObjectDataSource
    {
        private ObjectDataSourceView _view = null;
        private string _defaultViewName = "BookList";

        public CustomDataSource() : base() { }

        // Gets a view by name
        protected override DataSourceView GetView(string viewName)
        {
            // This data source only allows one view
            if (viewName != _defaultViewName)
            {
                return null;
            }
            else if (_view == null)
            {
                _view = new CustomDataSourceView(this, 
                    _defaultViewName, HttpContext.Current);
            }

            return _view;
        }

        // Gets a list of view names for this class
        protected override ICollection GetViewNames()
        {
            ArrayList ar = new ArrayList(1);
            ar.Add(_defaultViewName);
            return ar as ICollection;
        }
    }

    // The runtime data source view
    public class CustomDataSourceView : ObjectDataSourceView
    {
        private ArrayList _data = null;

        public CustomDataSourceView(CustomDataSource owner, 
            string viewName, HttpContext context)
            : base(owner, viewName, context)
        {
            owner.SelectCountMethod = "GetCount";
        }

        // This method would typically get a set of live data  
        // rather than create some dummy data
        protected override IEnumerable ExecuteSelect(
            DataSourceSelectArguments arguments)
        {
            if (_data == null)
            {
                // Create a set of runtime fake data
                _data = new ArrayList();
                _data.Add(new BookItem("ID_1", "Runtime Title 01"));
                _data.Add(new BookItem("ID_2", "Runtime Title 02"));
                _data.Add(new BookItem("ID_3", "Runtime Title 03"));
            }

            return _data as IEnumerable;
        }

        // Allow getting the record count
        public override bool CanRetrieveTotalRowCount
        {
            get { return true; }
        }

        // Returns the number of records in the current set of data
        public int GetCount()
        {
            if (_data == null)
                return 0;
            else
                return _data.Count;
        }
        
        // Do not allow deletions
        public override bool CanDelete
        {
            get { return false; }
        }
        // Do not allow insertions
        public override bool CanInsert
        {
            get { return false; }
        }
        // Do not allow paging
        public override bool CanPage
        {
            get { return false; }
        }
        // Do not allow sorting
        public override bool CanSort
        {
            get { return false; }
        }
        // Do not allow updating
        public override bool CanUpdate
        {
            get { return false; }
        }
    }

    // A class to define each record of the data
    public class BookItem
    {
        private string _id;
        private string _title;

        public BookItem(string id, string title)
        {
            _id = id;
            _title = title;
        }

        public string ID
        {
            get { return _id; }
        }
        public string Title
        {
            get { return _title; }
            set { _title = value; }
        }
    }

    // Custom designer for the CustomDataSource control.
    public class CustomDataSourceDesigner : DataSourceDesigner
    {
        private CustomDataSource _control;
        private string _defaultViewName = "BookList";
        private CustomDesignDataSourceView _view = null;

        // Initialize the designer
        public override void Initialize(IComponent component)
        {
            base.Initialize(component);
            _control = (CustomDataSource)Component;
        }

        // Get a view
        public override DesignerDataSourceView GetView(string viewName)
        {
            if (!viewName.Equals(_defaultViewName))
                return null;

            _view ??= new CustomDesignDataSourceView(this,
                _defaultViewName);

            return _view;
        }

        // Get a list of view names
        public override string[] GetViewNames()
        {
            return new string[] { "BookList" };
        }

        // Do not allow refreshing the schema
        public override bool CanRefreshSchema
        {
            get { return false; }
        }
        // Do not allow resizing
        public override bool AllowResize
        {
            get { return false; }
        }
    }

    // A design-time data source view
    public class CustomDesignDataSourceView : DesignerDataSourceView
    {
        private ArrayList _data = null;

        public CustomDesignDataSourceView(
            CustomDataSourceDesigner owner, string viewName)
            : base(owner, viewName)
        {}

        // Get data for design-time display
        public override IEnumerable GetDesignTimeData(
            int minimumRows, out bool isSampleData)
        {
            if (_data == null)
            {
                // Create a set of design-time fake data
                _data = new ArrayList();
                for (int i = 1; i <= minimumRows; i++)
                {
                    _data.Add(new BookItem("ID_" + i.ToString(),
                        "Design-Time Title 0" + i.ToString()));
                }
            }
            isSampleData = true;
            return _data as IEnumerable;
        }

        public override IDataSourceViewSchema Schema
        {
            get { return new BookListViewSchema(); }
        }

        // Allow getting the record count
        public override bool CanRetrieveTotalRowCount
        {
            get { return true; }
        }
        // Do not allow deletions
        public override bool CanDelete
        {
            get { return false; }
        }
        // Do not allow insertions
        public override bool CanInsert
        {
            get { return false; }
        }
        // Do not allow updates
        public override bool CanUpdate
        {
            get { return false; }
        }
        // Do not allow paging
        public override bool CanPage
        {
            get { return false; }
        }
        // Do not allow sorting
        public override bool CanSort
        {
            get { return false; }
        }
    }

    // A custom View Schema class
    public class BookListViewSchema : IDataSourceViewSchema
    {
        public BookListViewSchema()
        { }

        // The name of this View Schema
        public string Name
        {
            get { return "BookList"; }
        }

        // Build a Field Schema array
        public IDataSourceFieldSchema[] GetFields()
        {
            IDataSourceFieldSchema[] fields = new IDataSourceFieldSchema[2];
            fields[0] = new CustomIDFieldSchema();
            fields[1] = new CustomTitleFieldSchema();
            return fields;
        }
        // There are no child views, so return null
        public IDataSourceViewSchema[] GetChildren()
        {
            return null;
        }
    }

    // A custom Field Schema class for ID
    public class CustomIDFieldSchema : IDataSourceFieldSchema
    {
        public CustomIDFieldSchema()
        { }

        // Name is ID
        public string Name
        {
            get { return "ID"; }
        }
        // Data type is string
        public Type DataType
        {
            get { return typeof(string); }
        }
        // This is not an Identity field
        public bool Identity
        {
            get { return false; }
        }
        // This field is read only
        public bool IsReadOnly
        {
            get { return true; }
        }
        // This field is unique
        public bool IsUnique
        {
            get { return true; }
        }
        // This field can't be longer than 20
        public int Length
        {
            get { return 20; }
        }
        // This field can't be null
        public bool Nullable
        {
            get { return false; }
        }
        // This is a Primary Key
        public bool PrimaryKey
        {
            get { return true; }
        }

        // These properties do not apply
        public int Precision
        {
            get { return -1; }
        }
        public int Scale
        {
            get { return -1; }
        }
    }
    
    // A custom Field Schema class for Title
    public class CustomTitleFieldSchema : IDataSourceFieldSchema
    {
        public CustomTitleFieldSchema()
        { }

        // Name is Title
        public string Name
        {
            get { return "Title"; }
        }
        // Type is string
        public Type DataType
        {
            get { return typeof(string); }
        }
        // This is not an Identity field
        public bool Identity
        {
            get { return false; }
        }
        // This field is not read only
        public bool IsReadOnly
        {
            get { return false; }
        }
        // This field is not unique
        public bool IsUnique
        {
            get { return false; }
        }
        // This field can't be longer than 100
        public int Length
        {
            get { return 100; }
        }
        // This field can't be null
        public bool Nullable
        {
            get { return false; }
        }
        // This is not the Primary Key
        public bool PrimaryKey
        {
            get { return false; }
        }

        // These properties do not apply
        public int Precision
        {
            get { return -1; }
        }
        public int Scale
        {
            get { return -1; }
        }
    }
}
Imports System.Data
Imports System.Security.Permissions
Imports System.Collections
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.ComponentModel.Design

Namespace ASPNet.Design.Samples_VB
    <Designer(GetType(CustomDataSourceDesigner)), _
        ToolboxData("<{0}:CustomDataSource runat=""server""></{0}:CustomDataSource>")> _
    Public Class CustomDataSource
        Inherits ObjectDataSource

        Dim _defaultViewName As String = "BookList"
        Dim _view As ObjectDataSourceView = Nothing

        Public Sub New()
            MyBase.New()
        End Sub

        ' Gets a view by name
        Protected Overrides Function GetView(ByVal viewName As String) As DataSourceView
            ' This data source only allows one view
            If Not (viewName.Equals(_defaultViewName)) Then
                Return Nothing
            ElseIf IsNothing(_view) Then
                _view = New CustomDataSourceView(Me, _
                    _defaultViewName, HttpContext.Current)
            End If

            Return _view
        End Function

        ' Gets a list of view names for this class
        Protected Overrides Function GetViewNames() As ICollection
            Dim ar As New ArrayList()
            ar.Add(_defaultViewName)
            Return CType(ar, ICollection)
        End Function

    End Class

    ' The runtime data source view
    Public Class CustomDataSourceView
        Inherits ObjectDataSourceView

        Dim _data As ArrayList = Nothing

        Public Sub New(ByVal owner As CustomDataSource, ByVal viewName As String, ByVal context As HttpContext)
            MyBase.New(owner, viewName, context)
            owner.SelectCountMethod = "GetCount"
        End Sub

        ' This method would typically get a set of live data
        ' rather than create some dummy data
        Protected Overrides Function ExecuteSelect(ByVal arguments As DataSourceSelectArguments) As System.Collections.IEnumerable
            If (IsNothing(_data)) Then
                _data = New ArrayList()
                _data.Add(New BookItem("ID_1", "Runtime Title 01"))
                _data.Add(New BookItem("ID_2", "Runtime Title 02"))
                _data.Add(New BookItem("ID_3", "Runtime Title 03"))
            End If
            Return CType(_data, IEnumerable)
        End Function

        ' Allow getting the record count
        Public Overrides ReadOnly Property CanRetrieveTotalRowCount() As Boolean
            Get
                Return True
            End Get
        End Property

        ' Returns the number of records in the current set of data
        Public ReadOnly Property GetCount() As Integer
            Get
                If IsNothing(_data) Then
                    Return 0
                Else
                    Return _data.Count
                End If
            End Get
        End Property
        ' Do not allow deletions
        Public Overrides ReadOnly Property CanDelete() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow insertions
        Public Overrides ReadOnly Property CanInsert() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow paging
        Public Overrides ReadOnly Property CanPage() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow sorting
        Public Overrides ReadOnly Property CanSort() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow updating
        Public Overrides ReadOnly Property CanUpdate() As Boolean
            Get
                Return False
            End Get
        End Property

    End Class

    ' A class to define a record of the data
    Public Class BookItem
        Private _id As String
        Private _title As String

        Public Sub New(ByVal id As String, ByVal title As String)
            _id = id
            _title = title
        End Sub

        Public ReadOnly Property ID() As String
            Get
                Return _id
            End Get
        End Property

        Public Property Title() As String
            Get
                Return _title
            End Get
            Set(ByVal value As String)
                _title = value
            End Set
        End Property
    End Class

    ' Custom designer for the CustomDataSource control.
    Public Class CustomDataSourceDesigner
        Inherits DataSourceDesigner

        Private _control As CustomDataSource = Nothing
        Private _defaultViewName As String = "BookList"
        Private _view As CustomDesignDataSourceView = Nothing

        Public Overrides Sub Initialize(ByVal cmponent As IComponent)
            MyBase.Initialize(cmponent)
            _control = CType(cmponent, CustomDataSource)
        End Sub

        ' Get a view
        Public Overrides Function GetView(ByVal viewName As String) As DesignerDataSourceView
            If Not (viewName.Equals(_defaultViewName)) Then
                Return Nothing
            ElseIf IsNothing(_view) Then
                _view = New CustomDesignDataSourceView(Me, _
                    _defaultViewName)
            End If

            Return _view
        End Function

        ' Get a list of view names
        Public Overrides Function GetViewNames() As String()
            Return New String() {"BookList"}
        End Function

        ' Don't allow refreshing the schema
        Public Overrides ReadOnly Property CanRefreshSchema() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow resizing
        Public Overrides ReadOnly Property AllowResize() As Boolean
            Get
                Return False
            End Get
        End Property
    End Class

    ' A     design-time data source view
    Public Class CustomDesignDataSourceView
        Inherits DesignerDataSourceView

        Private _data As ArrayList = Nothing

        Public Sub New(ByVal owner As CustomDataSourceDesigner, ByVal viewName As String)
            MyBase.New(owner, viewName)
        End Sub

        ' Get data for design-time display
        Public Overrides Function GetDesignTimeData( _
            ByVal minimumRows As Integer, _
            ByRef isSampleData As Boolean) As IEnumerable

            If IsNothing(_data) Then
                ' Create a set of design-time fake data
                _data = New ArrayList()
                Dim i As Integer
                For i = 1 To minimumRows
                    _data.Add(New BookItem("ID_" & i.ToString(), _
                        "Design-Time Title 0" & i.ToString()))
                Next
            End If
            isSampleData = True
            Return CType(_data, IEnumerable)
        End Function

        Public Overrides ReadOnly Property Schema() As IDataSourceViewSchema
            Get
                Return New BookListViewSchema()
            End Get
        End Property

        ' Allow getting the record count
        Public Overrides ReadOnly Property CanRetrieveTotalRowCount() As Boolean
            Get
                Return True
            End Get
        End Property
        ' Do not allow deletions
        Public Overrides ReadOnly Property CanDelete() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow insertions
        Public Overrides ReadOnly Property CanInsert() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow updates
        Public Overrides ReadOnly Property CanUpdate() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow paging
        Public Overrides ReadOnly Property CanPage() As Boolean
            Get
                Return False
            End Get
        End Property
        ' Do not allow sorting
        Public Overrides ReadOnly Property CanSort() As Boolean
            Get
                Return False
            End Get
        End Property
    End Class

    ' A custom View Schema class
    Public Class BookListViewSchema
        Implements IDataSourceViewSchema

        Public Sub New()
        End Sub

        ' The name of this View Schema
        Public ReadOnly Property Name() As String Implements IDataSourceViewSchema.Name
            Get
                Return "BookList"
            End Get
        End Property

        ' Build a Field Schema array
        Public Function GetFields() As IDataSourceFieldSchema() Implements IDataSourceViewSchema.GetFields
            Dim fields(1) As IDataSourceFieldSchema
            fields(0) = New CustomIDFieldSchema()
            fields(1) = New CustomTitleFieldSchema()
            Return fields
        End Function
        ' There are no child views, so return Nothing
        Public Function GetChildren() As IDataSourceViewSchema() Implements IDataSourceViewSchema.GetChildren
            Return Nothing
        End Function
    End Class

    ' A custom Field Schema class for ID
    Public Class CustomIDFieldSchema
        Implements IDataSourceFieldSchema

        Public Sub New()
        End Sub

        ' Name is ID
        Public ReadOnly Property Name() As String Implements IDataSourceFieldSchema.Name
            Get
                Return "ID"
            End Get
        End Property
        ' Data type is string
        Public ReadOnly Property DataType() As Type Implements IDataSourceFieldSchema.DataType
            Get
                Return GetType(String)
            End Get
        End Property
        ' This is not an Identity field
        Public ReadOnly Property Identity() As Boolean Implements IDataSourceFieldSchema.Identity
            Get
                Return False
            End Get
        End Property
        ' This field is read only
        Public ReadOnly Property IsReadOnly() As Boolean Implements IDataSourceFieldSchema.IsReadOnly
            Get
                Return True
            End Get
        End Property
        ' This field is unique
        Public ReadOnly Property IsUnique() As Boolean Implements IDataSourceFieldSchema.IsUnique
            Get
                Return True
            End Get
        End Property
        ' This field can't be longer than 20
        Public ReadOnly Property Length() As Integer Implements IDataSourceFieldSchema.Length
            Get
                Return 20
            End Get
        End Property
        ' This field can't be null
        Public ReadOnly Property Nullable() As Boolean Implements IDataSourceFieldSchema.Nullable
            Get
                Return False
            End Get
        End Property
        ' This is a Primary Key
        Public ReadOnly Property PrimaryKey() As Boolean Implements IDataSourceFieldSchema.PrimaryKey
            Get
                Return True
            End Get
        End Property

        ' These properties do not apply
        Public ReadOnly Property Precision() As Integer Implements IDataSourceFieldSchema.Precision
            Get
                Return -1
            End Get
        End Property
        Public ReadOnly Property Scale() As Integer Implements IDataSourceFieldSchema.Scale
            Get
                Return -1
            End Get
        End Property
    End Class

    ' A custom Field Schema class for Title
    Public Class CustomTitleFieldSchema
        Implements IDataSourceFieldSchema

        Public Sub New()
        End Sub

        ' Name is Title
        Public ReadOnly Property Name() As String Implements IDataSourceFieldSchema.Name
            Get
                Return "Title"
            End Get
        End Property
        ' Type is string
        Public ReadOnly Property DataType() As Type Implements IDataSourceFieldSchema.DataType
            Get
                Return GetType(String)
            End Get
        End Property
        ' This is not an Identity field
        Public ReadOnly Property Identity() As Boolean Implements IDataSourceFieldSchema.Identity
            Get
                Return False
            End Get
        End Property
        ' This field is not read only
        Public ReadOnly Property IsReadOnly() As Boolean Implements IDataSourceFieldSchema.IsReadOnly
            Get
                Return False
            End Get
        End Property
        ' This field is not unique
        Public ReadOnly Property IsUnique() As Boolean Implements IDataSourceFieldSchema.IsUnique
            Get
                Return False
            End Get
        End Property
        ' This field can't be longer than 100
        Public ReadOnly Property Length() As Integer Implements IDataSourceFieldSchema.Length
            Get
                Return 100
            End Get
        End Property
        ' This field can't be null
        Public ReadOnly Property Nullable() As Boolean Implements IDataSourceFieldSchema.Nullable
            Get
                Return False
            End Get
        End Property
        ' This is not the Primary Key
        Public ReadOnly Property PrimaryKey() As Boolean Implements IDataSourceFieldSchema.PrimaryKey
            Get
                Return False
            End Get
        End Property

        ' These properties do not apply
        Public ReadOnly Property Precision() As Integer Implements IDataSourceFieldSchema.Precision
            Get
                Return -1
            End Get
        End Property
        Public ReadOnly Property Scale() As Integer Implements IDataSourceFieldSchema.Scale
            Get
                Return -1
            End Get
        End Property
    End Class

End Namespace
<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample" Namespace="ASPNet.Design.Samples_CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    <aspSample:CustomDataSource ID="CustomDS1" 
        runat="server"></aspSample:CustomDataSource>
    <asp:GridView ID="GridView1" runat="server"></asp:GridView>
    
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples_VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    <aspSample:CustomDataSource runat="server" 
        ID="CustomDS1"></aspSample:CustomDataSource>
    <asp:GridView ID="GridView1" runat="server"></asp:GridView>
    
    </div>
    </form>
</body>
</html>

Comentários

A DataSourceDesigner classe é a classe base para designers de fonte de dados, como as SqlDataSourceDesignerclasses , AccessDataSourceDesignere ObjectDataSourceDesigner . Se você criar um novo controle de fonte de dados, talvez também queira criar um designer de controle personalizado para seu controle e derive-o da DataSourceDesigner classe .

A DataSourceDesigner classe tem dois métodos de evento: os OnDataSourceChanged métodos e OnSchemaRefreshed . Ambos os eventos podem ser temporariamente desabilitados com o SuppressDataSourceEvents método , que define a SuppressingDataSourceEvents propriedade . Os métodos de evento podem ser habilitados novamente com o ResumeDataSourceEvents método .

Há dois métodos estáticos que você pode usar para avaliar a equivalência de esquemas ou exibições sem criar uma instância da classe :

Notas aos Herdeiros

Para fornecer comandos para o menu de lista de ações em tempo de design em uma classe derivada, você deve substituir a ActionLists propriedade para retornar um objeto personalizado DesignerActionListCollection com itens personalizados derivados do DesignerActionList objeto .

Construtores

DataSourceDesigner()

Inicializa uma nova instância da classe DataSourceDesigner.

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.

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.

CanRefreshSchema

Obtém um valor que indica se o método RefreshSchema(Boolean) pode ser chamado.

Component

Obtém o componente que deste designer está criando.

(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 da região que contém o controle associado.

(Herdado de ControlDesigner)
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)
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)
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)
SetTextualDefaultProperty

Fornece suporte de tempo de design em um host de design para a classe DataSourceControl.

(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.

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)
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.

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)
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 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)
GetDesignTimeHtml()

Recupera a marcação HTML para exibir o controle de fonte de dados associado em tempo de design.

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.

GetViewNames()

Retorna uma matriz dos nomes de exibição que estão disponíveis nessa fonte de dados.

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)
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.

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.

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)

Adiciona ou remove propriedades da grade de Propriedades em um host de design em tempo de design ou fornece novas propriedades de tempo de design que podem corresponder às propriedades do controle associado.

(Herdado de ControlDesigner)
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, enquanto suprime eventos opcionalmente.

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.

SchemasEquivalent(IDataSourceSchema, IDataSourceSchema)

Fornece um valor que indica se dois esquemas são iguais.

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.

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)
ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema)

Fornece um valor que determina se duas exibições de esquema são iguais.

Eventos

DataSourceChanged

Ocorre quando uma propriedade da fonte de dados associada é alterada.

SchemaRefreshed

Ocorre depois que o esquema foi atualizado.

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

Confira também