DataSourceDesigner Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.Design

Zestaw:: System.Design.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia obsługę czasu projektowania na hoście projektu dla DataSourceControl klasy .

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

Dziedziczenie: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
DataSourceDesigner

Pochodne: System.Web.UI.Design.WebControls.EntityDataSourceDesigner

System.Web.UI.Design.WebControls.LinqDataSourceDesigner

System.Web.UI.Design.WebControls.ObjectDataSourceDesigner

System.Web.UI.Design.WebControls.SqlDataSourceDesigner

Implementuje: IDataSourceDesigner

Przykłady

W poniższym przykładzie kodu pokazano, jak używać niestandardowej kontroli źródła danych z kilkoma innymi małymi klasami niestandardowymi, jak pokazano w poniższej tabeli.

Klasa niestandardowa	Pochodne od
`CustomDataSource`	ObjectDataSource
`CustomDataSourceDesigner`	DataSourceDesigner
`CustomDataSourceView`	ObjectDataSourceView
`CustomDesignDataSourceView`	DesignerDataSourceView
`BookListViewSchema`	IDataSourceViewSchema
`CustomIDFieldSchema`	IDataSourceFieldSchema
`CustomTitleFieldSchema`	IDataSourceFieldSchema
`BookItem` (Struktura danych z dwoma polami).

Po skompilowaniu przykładu kodu otwórz stronę .aspx w widoku projektu, a następnie ustaw DataSourceID właściwość na identyfikator niestandardowej kontroli źródła danych.

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>

Uwagi

Klasa DataSourceDesigner jest klasą bazową dla projektantów źródeł danych, takich jak SqlDataSourceDesignerklasy , AccessDataSourceDesigneri ObjectDataSourceDesigner . Jeśli tworzysz nową kontrolkę źródła danych, możesz również utworzyć niestandardowego projektanta kontrolek dla kontrolki i utworzyć go z DataSourceDesigner klasy .

Klasa DataSourceDesigner ma dwie metody zdarzeń: OnDataSourceChanged metody i OnSchemaRefreshed . Oba te zdarzenia można tymczasowo wyłączyć za SuppressDataSourceEvents pomocą metody , która ustawia SuppressingDataSourceEvents właściwość . Metody zdarzeń można włączyć ponownie za ResumeDataSourceEvents pomocą metody .

Istnieją dwie metody statyczne, których można użyć do oceny równoważności schematów lub widoków bez tworzenia wystąpienia klasy:

Metoda SchemasEquivalent porównuje dwa schematy.
Metoda ViewSchemasEquivalent porównuje schematy dwóch widoków.

Uwagi dotyczące dziedziczenia

Aby udostępnić polecenia menu listy akcji w czasie projektowania w klasie pochodnej, należy zastąpić ActionLists właściwość , aby zwrócić obiekt niestandardowy z elementami niestandardowymi DesignerActionListCollection pochodzącymi z DesignerActionList obiektu.

Konstruktory

DataSourceDesigner()

Inicjuje nowe wystąpienie klasy DataSourceDesigner.

Właściwości

ActionLists	Pobiera listę elementów, które są używane do tworzenia menu listy akcji w czasie projektowania.
AllowResize	Pobiera wartość wskazującą, czy rozmiar kontrolki można zmienić w środowisku czasu projektowania. (Odziedziczone po ControlDesigner)
AssociatedComponents	Pobiera kolekcję składników skojarzonych ze składnikiem zarządzanym przez projektanta. (Odziedziczone po ComponentDesigner)
AutoFormats	Pobiera kolekcję wstępnie zdefiniowanych schematów automatycznego formatowania do wyświetlenia w oknie dialogowym Automatyczne formatowanie skojarzonej kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner)
Behavior	Przestarzałe. Pobiera lub ustawia zachowanie DHTML skojarzone z projektantem. (Odziedziczone po HtmlControlDesigner)
CanConfigure	Pobiera wartość wskazującą, czy można wywołać metodę Configure() .
CanRefreshSchema	Pobiera wartość wskazującą, czy można wywołać metodę RefreshSchema(Boolean) .
Component	Pobiera składnik, który projektuje ten projektant. (Odziedziczone po ComponentDesigner)
DataBindings	Pobiera kolekcję powiązań danych dla bieżącej kontrolki. (Odziedziczone po HtmlControlDesigner)
DataBindingsEnabled	Pobiera wartość wskazującą, czy powiązanie danych jest obsługiwane przez region zawierający dla skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
DesignerState	Pobiera obiekt, który jest używany do utrwalania danych skojarzonej kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner)
DesignTimeElement	Przestarzałe. Pobiera obiekt czasu projektowania reprezentujący kontrolkę skojarzona z obiektem HtmlControlDesigner na powierzchni projektowej. (Odziedziczone po HtmlControlDesigner)
DesignTimeElementView	Przestarzałe. Pobiera obiekt kontrolki widoku dla projektanta kontrolek. (Odziedziczone po ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Przestarzałe. Pobiera wartość wskazującą, czy host projektu musi zakończyć ładowanie, zanim będzie można wywołać metodę GetDesignTimeHtml . (Odziedziczone po ControlDesigner)
Expressions	Pobiera powiązania wyrażeń dla bieżącej kontrolki w czasie projektowania. (Odziedziczone po HtmlControlDesigner)
HidePropertiesInTemplateMode	Pobiera wartość wskazującą, czy właściwości skojarzonej kontrolki są ukryte, gdy kontrolka jest w trybie szablonu. (Odziedziczone po ControlDesigner)
ID	Pobiera lub ustawia ciąg identyfikatora dla kontrolki. (Odziedziczone po ControlDesigner)
InheritanceAttribute	Pobiera atrybut wskazujący typ dziedziczenia skojarzonego składnika. (Odziedziczone po ComponentDesigner)
Inherited	Pobiera wartość wskazującą, czy ten składnik jest dziedziczony. (Odziedziczone po ComponentDesigner)
InTemplateMode	Pobiera wartość wskazującą, czy kontrolka jest w trybie wyświetlania szablonu lub edycji na hoście projektu. Właściwość InTemplateMode jest tylko do odczytu. (Odziedziczone po ControlDesigner)
IsDirty	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web została oznaczona jako zmieniona. (Odziedziczone po ControlDesigner)
ParentComponent	Pobiera składnik nadrzędny dla tego projektanta. (Odziedziczone po ComponentDesigner)
ReadOnly	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy właściwości kontrolki są tylko do odczytu w czasie projektowania. (Odziedziczone po ControlDesigner)
RootDesigner	Pobiera projektanta kontrolek dla strony Formularze sieci Web zawierającej skojarzona kontrolkę. (Odziedziczone po ControlDesigner)
SetTextualDefaultProperty	Zapewnia obsługę czasu projektowania na hoście projektu dla DataSourceControl klasy . (Odziedziczone po ComponentDesigner)
ShadowProperties	Pobiera kolekcję wartości właściwości, które zastępują ustawienia użytkownika. (Odziedziczone po ComponentDesigner)
ShouldCodeSerialize	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy podczas serializacji utworzyć deklarację pola dla kontrolki w pliku za kodem dla bieżącego dokumentu projektowego. (Odziedziczone po HtmlControlDesigner)
SuppressingDataSourceEvents	Pobiera wartość wskazującą, DataSourceChanged czy występuje zdarzenie, czy RefreshSchema(Boolean) metoda.
Tag	Pobiera obiekt reprezentujący element znaczników HTML dla skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
TemplateGroups	Pobiera kolekcję grup szablonów, z których każda zawiera co najmniej jedną definicję szablonu. (Odziedziczone po ControlDesigner)
UsePreviewControl	Pobiera wartość wskazującą, czy projektant kontrolek używa tymczasowej kontrolki podglądu do generowania znacznika HTML w czasie projektowania. (Odziedziczone po ControlDesigner)
Verbs	Pobiera czas projektowania czasowniki obsługiwane przez składnik skojarzony z projektantem. (Odziedziczone po ComponentDesigner)
ViewControl	Pobiera lub ustawia kontrolkę serwera sieci Web, która może służyć do wyświetlania podglądu znacznika HTML w czasie projektowania. (Odziedziczone po ControlDesigner)
ViewControlCreated	Pobiera lub ustawia wartość wskazującą, czy kontrolka `View` została utworzona do wyświetlania na powierzchni projektowej. (Odziedziczone po ControlDesigner)
Visible	Pobiera wartość wskazującą, czy kontrolka jest widoczna w czasie projektowania. (Odziedziczone po ControlDesigner)

Metody

Configure()	Uruchamia narzędzie konfiguracji źródła danych na hoście projektu.
CreateErrorDesignTimeHtml(String)	Tworzy adiustację HTML w celu wyświetlenia określonego komunikatu o błędzie w czasie projektowania. (Odziedziczone po ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Tworzy znacznik HTML w celu wyświetlenia określonego komunikatu o błędzie wyjątku w czasie projektowania. (Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Zawiera prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki. (Odziedziczone po ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Zawiera prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki, a także dodatkowe określone instrukcje lub informacje. (Odziedziczone po ControlDesigner)
CreateViewControl()	Zwraca kopię skojarzonej kontrolki do wyświetlania lub renderowania na powierzchni projektowej. (Odziedziczone po ControlDesigner)
Dispose()	Zwalnia wszelkie zasoby używane przez element ComponentDesigner. (Odziedziczone po ComponentDesigner)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez HtmlControlDesigner obiekt i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po HtmlControlDesigner)
DoDefaultAction()	Tworzy podpis metody w pliku kodu źródłowego dla zdarzenia domyślnego w składniku i przechodzi kursor użytkownika do tej lokalizacji. (Odziedziczone po ComponentDesigner)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBounds()	Pobiera współrzędne prostokąta reprezentującego granice kontrolki wyświetlane na powierzchni projektowej. (Odziedziczone po ControlDesigner)
GetDesignTimeHtml()	Pobiera znacznik HTML do wyświetlania skojarzonej kontroli źródła danych w czasie projektowania.
GetDesignTimeHtml(DesignerRegionCollection)	Pobiera znacznik HTML, aby wyświetlić kontrolkę i wypełnić kolekcję bieżącymi regionami projektanta kontrolek. (Odziedziczone po ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Zwraca zawartość dla edytowalnego regionu widoku czasu projektowania skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
GetEmptyDesignTimeHtml()	Pobiera znacznik HTML reprezentujący kontrolkę serwera sieci Web w czasie projektowania, która nie będzie miała wizualnej reprezentacji w czasie wykonywania. (Odziedziczone po ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Pobiera znacznik HTML, który zawiera informacje o określonym wyjątku. (Odziedziczone po ControlDesigner)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetPersistenceContent()	Pobiera trwały wewnętrzny kod HTML kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner)
GetPersistInnerHtml()	Przestarzałe. Pobiera utrwalane wewnętrzne znaczniki HTML kontrolki. (Odziedziczone po ControlDesigner)
GetService(Type)	Próbuje pobrać określony typ usługi z witryny trybu projektowania składnika projektanta. (Odziedziczone po ComponentDesigner)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetView(String)	DesignerDataSourceView Pobiera obiekt, który jest identyfikowany przez nazwę widoku.
GetViewNames()	Zwraca tablicę nazw widoków dostępnych w tym źródle danych.
GetViewRendering()	Pobiera obiekt zawierający znacznik czasu projektowania dla zawartości i regionów skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
Initialize(IComponent)	Inicjuje projektanta kontrolek i ładuje określony składnik. (Odziedziczone po ControlDesigner)
InitializeExistingComponent(IDictionary)	Ponownie inicjuje istniejący składnik. (Odziedziczone po ComponentDesigner)
InitializeNewComponent(IDictionary)	Inicjuje nowo utworzony składnik. (Odziedziczone po ComponentDesigner)
InitializeNonDefault()	Przestarzałe. Przestarzałe. Inicjuje ustawienia zaimportowanego składnika, który jest już inicjowany do ustawień innych niż domyślne. (Odziedziczone po ComponentDesigner)
Invalidate()	Unieważnia cały obszar kontrolki, który jest wyświetlany na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki. (Odziedziczone po ControlDesigner)
Invalidate(Rectangle)	Unieważnia określony obszar kontrolki, który jest wyświetlany na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki. (Odziedziczone po ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Pobiera element InheritanceAttribute określonego ComponentDesignerelementu . (Odziedziczone po ComponentDesigner)
IsPropertyBound(String)	Przestarzałe. Pobiera wartość wskazującą, czy określona właściwość skojarzonej kontrolki jest powiązana z danymi. (Odziedziczone po ControlDesigner)
Localize(IDesignTimeResourceWriter)	Używa dostarczonego składnika zapisywania zasobów do utrwalania zlokalizowanych właściwości skojarzonej kontrolki z zasobem na hoście projektu. (Odziedziczone po ControlDesigner)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnAutoFormatApplied(DesignerAutoFormat)	Wywoływana w przypadku wstępnie zdefiniowanego schematu automatycznego formatowania została zastosowana do skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
OnBehaviorAttached()	Wywoływana, gdy projektant kontrolek jest dołączony do obiektu Zachowanie. (Odziedziczone po ControlDesigner)
OnBehaviorDetaching()	Przestarzałe. Wywoływana, gdy zachowanie nie jest skojarzone z elementem. (Odziedziczone po HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Przestarzałe. Wywoływana, gdy zmienia się kolekcja powiązań danych. (Odziedziczone po ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Wywoływana przez hosta projektu, gdy użytkownik kliknie skojarzona kontrolka w czasie projektowania. (Odziedziczone po ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Wywoływana po zmianie skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Reprezentuje metodę, która będzie obsługiwać ComponentChanging zdarzenie dla skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
OnControlResize()	Przestarzałe. Wywoływana, gdy rozmiar skojarzonej kontrolki serwera sieci Web został zmieniony na hoście projektu w czasie projektowania. (Odziedziczone po ControlDesigner)
OnDataSourceChanged(EventArgs)	DataSourceChanged Zgłasza zdarzenie, gdy właściwości źródła danych uległy zmianie, a SuppressingDataSourceEvents wartość to `false`.
OnPaint(PaintEventArgs)	Wywoływana, gdy projektant kontrolek rysuje skojarzona kontrolka na powierzchni projektowej CustomPaint , jeśli wartość to `true`. (Odziedziczone po ControlDesigner)
OnSchemaRefreshed(EventArgs)	SchemaRefreshed Zgłasza zdarzenie, gdy schemat źródła danych uległ zmianie, a SuppressingDataSourceEvents wartość to `false`.
OnSetComponentDefaults()	Przestarzałe. Przestarzałe. Ustawia domyślne właściwości składnika. (Odziedziczone po ComponentDesigner)
OnSetParent()	Zapewnia sposób wykonywania dodatkowego przetwarzania, gdy skojarzona kontrolka jest dołączona do kontrolki nadrzędnej. (Odziedziczone po HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu atrybutów, które uwidacznia za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner)
PostFilterEvents(IDictionary)	Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu zdarzeń udostępnianych za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner)
PostFilterProperties(IDictionary)	Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu właściwości, które uwidacznia za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner)
PreFilterAttributes(IDictionary)	Umożliwia projektantowi dodanie do zestawu atrybutów, które uwidacznia za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner)
PreFilterEvents(IDictionary)	Ustawia listę zdarzeń, które są widoczne w czasie projektowania dla TypeDescriptor obiektu składnika. (Odziedziczone po HtmlControlDesigner)
PreFilterProperties(IDictionary)	Dodaje właściwości do siatki właściwości lub usuwa je z siatki Właściwości na hoście projektu w czasie projektowania lub udostępnia nowe właściwości czasu projektowania, które mogą odpowiadać właściwościom skojarzonej kontrolki. (Odziedziczone po ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Powiadamia o IComponentChangeService zmianie tego składnika. (Odziedziczone po ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Powiadamia o tym IComponentChangeService , że ten składnik ma zostać zmieniony. (Odziedziczone po ComponentDesigner)
RaiseResizeEvent()	Przestarzałe. OnControlResize() Zgłasza zdarzenie. (Odziedziczone po ControlDesigner)
RefreshSchema(Boolean)	Odświeża schemat ze źródła danych, a opcjonalnie pomija zdarzenia.
RegisterClone(Object, Object)	Rejestruje dane wewnętrzne w sklonowanej kontrolce. (Odziedziczone po ControlDesigner)
ResumeDataSourceEvents()	Przywraca zdarzenia źródła danych po tym, jak zdarzenia źródła danych zostały pominięte.
SchemasEquivalent(IDataSourceSchema, IDataSourceSchema)	Zawiera wartość wskazującą, czy dwa schematy są równe.
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Określa zawartość dla edytowalnego regionu kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Określa zawartość regionu edytowalnego w widoku czasu projektowania kontrolki. (Odziedziczone po ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Przypisuje określone wyliczenie bitowe ViewFlags do określonej wartości flagi. (Odziedziczone po ControlDesigner)
SuppressDataSourceEvents()	Odroczy wszystkie zdarzenia źródła danych do momentu wywołania ResumeDataSourceEvents() metody .
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
UpdateDesignTimeHtml()	Odświeża znaczniki HTML czasu projektowania dla skojarzonej kontrolki serwera sieci Web, wywołując metodę GetDesignTimeHtml . (Odziedziczone po ControlDesigner)
ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema)	Zawiera wartość określającą, czy dwa widoki schematu są równe.

Zdarzenia

DataSourceChanged	Występuje, gdy zmienia się dowolna właściwość skojarzonego źródła danych.
SchemaRefreshed	Występuje po odświeżeniu schematu.

Jawne implementacje interfejsu

IDesignerFilter.PostFilterAttributes(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterAttributes(IDictionary) . (Odziedziczone po ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterEvents(IDictionary) . (Odziedziczone po ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterProperties(IDictionary) . (Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterAttributes(IDictionary) . (Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterEvents(IDictionary) . (Odziedziczone po ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterProperties(IDictionary) . (Odziedziczone po ComponentDesigner)
ITreeDesigner.Children	Aby uzyskać opis tego elementu członkowskiego, zobacz Children właściwość . (Odziedziczone po ComponentDesigner)
ITreeDesigner.Parent	Aby uzyskać opis tego elementu członkowskiego, zobacz Parent właściwość . (Odziedziczone po ComponentDesigner)

Dotyczy

Udostępnij za pośrednictwem