DataSourceDesigner Класс

Определение

Предоставляет поддержку во время разработки в узле разработки для класса 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
Наследование
Производный
Реализации

Примеры

В следующем примере кода показано, как использовать пользовательский элемент управления источником данных с несколькими другими небольшими пользовательскими классами, как показано в следующей таблице.

Пользовательский класс Унаследован от
CustomDataSource ObjectDataSource
CustomDataSourceDesigner DataSourceDesigner
CustomDataSourceView ObjectDataSourceView
CustomDesignDataSourceView DesignerDataSourceView
BookListViewSchema IDataSourceViewSchema
CustomIDFieldSchema IDataSourceFieldSchema
CustomTitleFieldSchema IDataSourceFieldSchema
BookItem (Структура данных с двумя полями.)

После компиляции примера кода откройте страницу ASPX в режиме конструктора и присвойте свойству DataSourceID идентификатор пользовательского элемента управления источником данных.

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>

Комментарии

Класс DataSourceDesigner является базовым классом для конструкторов источников данных, таких как SqlDataSourceDesignerклассы , AccessDataSourceDesignerи ObjectDataSourceDesigner . При создании нового элемента управления источником данных также может потребоваться создать пользовательский конструктор элементов управления для элемента управления и наследовать его от DataSourceDesigner класса .

Класс DataSourceDesigner имеет два метода событий: методы OnDataSourceChanged и OnSchemaRefreshed . Оба этих события можно временно отключить с помощью SuppressDataSourceEvents метода , который задает SuppressingDataSourceEvents свойство . Методы событий можно снова включить с помощью ResumeDataSourceEvents метода .

Существует два статических метода, которые можно использовать для оценки эквивалентности схем или представлений без создания экземпляра класса :

Примечания для тех, кто наследует этот метод

Чтобы предоставить команды для меню списка действий во время разработки в производном классе, необходимо переопределить ActionLists свойство , чтобы вернуть пользовательский DesignerActionListCollection объект с пользовательскими элементами, производными от DesignerActionList объекта .

Конструкторы

DataSourceDesigner()

Инициализирует новый экземпляр класса DataSourceDesigner.

Свойства

ActionLists

Получает список элементов, используемых для создания меню списка действий во время разработки.

AllowResize

Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки.

(Унаследовано от ControlDesigner)
AssociatedComponents

Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором.

(Унаследовано от ComponentDesigner)
AutoFormats

Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки.

(Унаследовано от ControlDesigner)
Behavior
Устаревшие..

Получает или задает поведение DHTML, связанное с конструктором.

(Унаследовано от HtmlControlDesigner)
CanConfigure

Получает значение, показывающее, может ли быть вызван метод Configure().

CanRefreshSchema

Получает значение, показывающее, может ли быть вызван метод RefreshSchema(Boolean).

Component

Возвращает основной компонент, создаваемый данным конструктором.

(Унаследовано от ComponentDesigner)
DataBindings

Получает коллекцию привязок данных для текущего элемента управления.

(Унаследовано от HtmlControlDesigner)
DataBindingsEnabled

Получает значение, указывающее, поддерживается ли привязка данных областью, содержащей элемент управления.

(Унаследовано от ControlDesigner)
DesignerState

Получает объект, используемый для сохранения данных сопоставленного элемента управления во время разработки.

(Унаследовано от ControlDesigner)
DesignTimeElement
Устаревшие..

Возвращает объект времени разработки, представляющий элемент управления, сопоставленный с объектом HtmlControlDesigner в области разработки.

(Унаследовано от HtmlControlDesigner)
DesignTimeElementView
Устаревшие..

Получает объект элемента управления представлением для конструктора элементов управления.

(Унаследовано от ControlDesigner)
DesignTimeHtmlRequiresLoadComplete
Устаревшие..

Получает значение, указывающее, должна ли быть завершена загрузка основным приложением разработки до вызова метода GetDesignTimeHtml.

(Унаследовано от ControlDesigner)
Expressions

Возвращает привязки выражений для текущего элемента управления во время разработки.

(Унаследовано от HtmlControlDesigner)
HidePropertiesInTemplateMode

Получает значение, указывающее, скрыты ли свойства сопоставленного элемента управления, когда он находится в режиме шаблона.

(Унаследовано от ControlDesigner)
ID

Получает или задает строку идентификатора элемента управления.

(Унаследовано от ControlDesigner)
InheritanceAttribute

Возвращает атрибут, обозначающий тип наследования связанного компонента.

(Унаследовано от ComponentDesigner)
Inherited

Возвращает значение, определяющее, наследуется ли этот компонент или нет.

(Унаследовано от ComponentDesigner)
InTemplateMode

получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в основном приложении разработки. Свойство InTemplateMode доступно только для чтения.

(Унаследовано от ControlDesigner)
IsDirty
Устаревшие..

Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления.

(Унаследовано от ControlDesigner)
ParentComponent

Возвращает родительский компонент этого конструктора.

(Унаследовано от ComponentDesigner)
ReadOnly
Устаревшие..

Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки.

(Унаследовано от ControlDesigner)
RootDesigner

Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления.

(Унаследовано от ControlDesigner)
SetTextualDefaultProperty

Предоставляет поддержку во время разработки в узле разработки для класса DataSourceControl.

(Унаследовано от ComponentDesigner)
ShadowProperties

Возвращает коллекцию значений свойств, переопределяющих параметры пользователя.

(Унаследовано от ComponentDesigner)
ShouldCodeSerialize
Устаревшие..

Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации.

(Унаследовано от HtmlControlDesigner)
SuppressingDataSourceEvents

Получает значение, показывающее, происходит ли событие DataSourceChanged или метод RefreshSchema(Boolean).

Tag

Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления.

(Унаследовано от ControlDesigner)
TemplateGroups

Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов.

(Унаследовано от ControlDesigner)
UsePreviewControl

Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки.

(Унаследовано от ControlDesigner)
Verbs

Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором.

(Унаследовано от ComponentDesigner)
ViewControl

Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки.

(Унаследовано от ControlDesigner)
ViewControlCreated

Получает или задает значение, указывающее, создан ли элемент управления View для отображения в рабочей области конструирования.

(Унаследовано от ControlDesigner)
Visible

Получает значение, указывающее, является ли элемент управления видимым во время разработки.

(Унаследовано от ControlDesigner)

Методы

Configure()

Запускает служебную программу конфигурации источника данных на узле разработки.

CreateErrorDesignTimeHtml(String)

Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки.

(Унаследовано от ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)

Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением.

(Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления.

(Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения.

(Унаследовано от ControlDesigner)
CreateViewControl()

Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования.

(Унаследовано от ControlDesigner)
Dispose()

Освобождает все ресурсы, занятые модулем ComponentDesigner.

(Унаследовано от ComponentDesigner)
Dispose(Boolean)

Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner.

(Унаследовано от HtmlControlDesigner)
DoDefaultAction()

Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись.

(Унаследовано от ComponentDesigner)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetBounds()

Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования.

(Унаследовано от ControlDesigner)
GetDesignTimeHtml()

Возвращает разметку HTML для отображения связанного элемента управления источника данных во время разработки.

GetDesignTimeHtml(DesignerRegionCollection)

Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления.

(Унаследовано от ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)

Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления.

(Унаследовано от ControlDesigner)
GetEmptyDesignTimeHtml()

Извлекает разметку HTML, используемую для представления северного веб-элемента управления во время разработки, у которого не будет визуального представления во время выполнения.

(Унаследовано от ControlDesigner)
GetErrorDesignTimeHtml(Exception)

Получает HTML-разметку, которая предоставляет сведения об указанном исключении.

(Унаследовано от ControlDesigner)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetPersistenceContent()

Получает сохраненную внутреннюю разметку HTML элемента управления во время разработки.

(Унаследовано от ControlDesigner)
GetPersistInnerHtml()
Устаревшие..

Получает сохраненную внутреннюю разметку HTML элемента управления.

(Унаследовано от ControlDesigner)
GetService(Type)

Пытается извлечь службу заданного типа с узла режима разработки компонента конструктора.

(Унаследовано от ComponentDesigner)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
GetView(String)

Извлекает объект DesignerDataSourceView, определяемый именем представления.

GetViewNames()

Возвращает массив имен представлений, доступных в этом источнике данных.

GetViewRendering()

Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления.

(Унаследовано от ControlDesigner)
Initialize(IComponent)

Инициализирует конструктор элементов управления и загружает указанный компонент.

(Унаследовано от ControlDesigner)
InitializeExistingComponent(IDictionary)

Выполняет повторную инициализацию существующего компонента.

(Унаследовано от ComponentDesigner)
InitializeNewComponent(IDictionary)

Инициализирует только что созданный компонент.

(Унаследовано от ComponentDesigner)
InitializeNonDefault()
Устаревшие..
Устаревшие..

Инициализирует параметры импортированного компонента, параметры которого уже были инициализированы с использованием параметров, отличных от заданных по умолчанию.

(Унаследовано от ComponentDesigner)
Invalidate()

Делает недействительной целую область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элементов управления о необходимости перерисовки элемента управления.

(Унаследовано от ControlDesigner)
Invalidate(Rectangle)

Делает недействительной указанную область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элемента управления о необходимости перерисовки элемента управления.

(Унаследовано от ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

Возвращает атрибут InheritanceAttribute заданного объекта ComponentDesigner.

(Унаследовано от ComponentDesigner)
IsPropertyBound(String)
Устаревшие..

Получает значение, указывающее, является ли указанное свойство сопоставленного элемента управления привязанным к данным.

(Унаследовано от ControlDesigner)
Localize(IDesignTimeResourceWriter)

Использует предоставленный модуль записи ресурсов для сохранения локализуемых свойств сопоставленного элемента управления в ресурсе основного приложения разработки.

(Унаследовано от ControlDesigner)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
OnAutoFormatApplied(DesignerAutoFormat)

Вызывается, когда предварительно определенная схема автоматического форматирования применяется к сопоставленному элементу управления.

(Унаследовано от ControlDesigner)
OnBehaviorAttached()

Вызывается, когда конструктор элемента управления вложен в объект Behavior.

(Унаследовано от ControlDesigner)
OnBehaviorDetaching()
Устаревшие..

Вызывается при разрыве связи поведения и элемента.

(Унаследовано от HtmlControlDesigner)
OnBindingsCollectionChanged(String)
Устаревшие..

Вызывается при изменении коллекции привязки данных.

(Унаследовано от ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления.

(Унаследовано от ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)

Вызывается при изменении сопоставленного элемента управления.

(Унаследовано от ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

Предоставляет метод, обрабатывающий событие ComponentChanging для сопоставленного элемента управления.

(Унаследовано от ControlDesigner)
OnControlResize()
Устаревшие..

Вызывается, когда изменяется размер сопоставленного серверного веб-элемента управления в основном приложении разработки во время разработки.

(Унаследовано от ControlDesigner)
OnDataSourceChanged(EventArgs)

Вызывает событие DataSourceChanged, если свойства источника данных были изменены и значение свойства SuppressingDataSourceEvents равно false.

OnPaint(PaintEventArgs)

Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является true.

(Унаследовано от ControlDesigner)
OnSchemaRefreshed(EventArgs)

Вызывает событие SchemaRefreshed, если схема источника данных была изменена и значение свойства SuppressingDataSourceEvents равно false.

OnSetComponentDefaults()
Устаревшие..
Устаревшие..

Задает для компонента свойства по умолчанию.

(Унаследовано от ComponentDesigner)
OnSetParent()

Предоставляет способ выполнения дополнительной обработки, когда сопоставленный элемент управления сопоставляется с родительским элементом управления.

(Унаследовано от HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставленных через класс TypeDescriptor.

(Унаследовано от ComponentDesigner)
PostFilterEvents(IDictionary)

Позволяет конструктору изменять или удалять элементы из набора событий, предоставленных через класс TypeDescriptor.

(Унаследовано от ComponentDesigner)
PostFilterProperties(IDictionary)

Позволяет конструктору изменять или удалять элементы из набора свойств, предоставленных с использованием класса TypeDescriptor.

(Унаследовано от ComponentDesigner)
PreFilterAttributes(IDictionary)

Позволяет конструктору добавлять элементы к набору атрибутов, предоставленному с использованием класса TypeDescriptor.

(Унаследовано от ComponentDesigner)
PreFilterEvents(IDictionary)

Определяет список событий, предоставляемых во время разработки для объекта TypeDescriptor компонента.

(Унаследовано от HtmlControlDesigner)
PreFilterProperties(IDictionary)

Добавляет свойства в сетку свойств в основном приложении разработки во время разработки или удаляет их из этой сетки либо предоставляет новые свойства времени разработки, которые могут соответствовать свойствам сопоставленного элемента управления.

(Унаследовано от ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)

Уведомляет службу IComponentChangeService о том, что данный компонент был изменен.

(Унаследовано от ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Уведомляет службу IComponentChangeService о том, что компонент будет изменен.

(Унаследовано от ComponentDesigner)
RaiseResizeEvent()
Устаревшие..

Вызывает событие OnControlResize().

(Унаследовано от ControlDesigner)
RefreshSchema(Boolean)

Обновляет схему из источника данных, одновременно подавляя события (если это указано).

RegisterClone(Object, Object)

Регистрирует внутренние данные в клонированном элементе управления.

(Унаследовано от ControlDesigner)
ResumeDataSourceEvents()

Восстанавливает события источников данных после их подавления.

SchemasEquivalent(IDataSourceSchema, IDataSourceSchema)

Предоставляет значение, показывающее, эквивалентны ли две схемы.

SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Указывает содержимое редактируемой области элемента управления во время разработки.

(Унаследовано от ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)

Указывает содержимое редактируемой области в представлении времени разработки элемента управления.

(Унаследовано от ControlDesigner)
SetViewFlags(ViewFlags, Boolean)

Назначает указанное битовое перечисление ViewFlags указанному значению флага.

(Унаследовано от ControlDesigner)
SuppressDataSourceEvents()

Откладывает все события источника данных до вызова метода ResumeDataSourceEvents().

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
UpdateDesignTimeHtml()

Обновляет разметку HTML времени разработки для сопоставленного серверного веб-элемента управления посредством вызова метода GetDesignTimeHtml.

(Унаследовано от ControlDesigner)
ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema)

Предоставляет значение, определяющее, эквивалентны ли два представления схемы.

События

DataSourceChanged

Происходит при изменении любого свойства связанного источника данных.

SchemaRefreshed

Происходит после обновления схемы.

Явные реализации интерфейса

IDesignerFilter.PostFilterAttributes(IDictionary)

Описание этого элемента содержится в методе PostFilterAttributes(IDictionary).

(Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Описание этого элемента содержится в методе PostFilterEvents(IDictionary).

(Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Описание этого элемента содержится в методе PostFilterProperties(IDictionary).

(Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Описание этого элемента содержится в методе PreFilterAttributes(IDictionary).

(Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Описание этого элемента содержится в методе PreFilterEvents(IDictionary).

(Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Описание этого элемента содержится в методе PreFilterProperties(IDictionary).

(Унаследовано от ComponentDesigner)
ITreeDesigner.Children

Описание этого элемента см. в свойстве Children.

(Унаследовано от ComponentDesigner)
ITreeDesigner.Parent

Описание этого элемента см. в свойстве Parent.

(Унаследовано от ComponentDesigner)

Применяется к

См. также раздел