Partager via


DataSourceDesigner Classe

Définition

Fournit la prise en charge au moment du design dans un hôte de conception pour la classe DataSourceControl.

public ref class DataSourceDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceDesigner
public class DataSourceDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceDesigner
type DataSourceDesigner = class
    inherit ControlDesigner
    interface IDataSourceDesigner
Public Class DataSourceDesigner
Inherits ControlDesigner
Implements IDataSourceDesigner
Héritage
Dérivé
Implémente

Exemples

L’exemple de code suivant montre comment utiliser un contrôle de source de données personnalisé avec plusieurs autres petites classes personnalisées, comme indiqué dans le tableau suivant.

Classe personnalisée Dérivé de
CustomDataSource ObjectDataSource
CustomDataSourceDesigner DataSourceDesigner
CustomDataSourceView ObjectDataSourceView
CustomDesignDataSourceView DesignerDataSourceView
BookListViewSchema IDataSourceViewSchema
CustomIDFieldSchema IDataSourceFieldSchema
CustomTitleFieldSchema IDataSourceFieldSchema
BookItem (Structure de données à deux champs.)

Après avoir compilé l’exemple de code, ouvrez la page .aspx en mode Création, puis définissez la DataSourceID propriété sur l’ID du contrôle de source de données personnalisé.

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>

Remarques

La DataSourceDesigner classe est la classe de base pour les concepteurs de sources de données, tels que les SqlDataSourceDesignerclasses , AccessDataSourceDesigneret ObjectDataSourceDesigner . Si vous créez un contrôle de source de données, vous pouvez également créer un concepteur de contrôles personnalisé pour votre contrôle et le dériver de la DataSourceDesigner classe .

La DataSourceDesigner classe a deux méthodes d’événement : les OnDataSourceChanged méthodes et OnSchemaRefreshed . Ces deux événements peuvent être temporairement désactivés avec la SuppressDataSourceEvents méthode, qui définit la SuppressingDataSourceEvents propriété . Les méthodes d’événement peuvent être à nouveau activées avec la ResumeDataSourceEvents méthode .

Il existe deux méthodes statiques que vous pouvez utiliser pour évaluer l’équivalence des schémas ou des vues sans créer d’instance de la classe :

Notes pour les héritiers

Pour fournir des commandes pour le menu de liste d’actions au moment de la conception dans une classe dérivée, vous devez remplacer la ActionLists propriété pour renvoyer un objet personnalisé DesignerActionListCollection avec des éléments personnalisés dérivés de l’objet DesignerActionList .

Constructeurs

DataSourceDesigner()

Initialise une nouvelle instance de la classe DataSourceDesigner.

Propriétés

ActionLists

Obtient une liste des éléments utilisés pour créer un menu de liste d'actions au moment du design.

AllowResize

Obtient une valeur indiquant si le contrôle peut être redimensionné dans l'environnement au moment du design.

(Hérité de ControlDesigner)
AssociatedComponents

Obtient la collection de composants associés au composant géré par le concepteur.

(Hérité de ComponentDesigner)
AutoFormats

Obtient la collection de schémas de mise en forme automatique prédéfinis à afficher dans la boîte de dialogue Mise en forme automatique pour le contrôle associé au moment du design.

(Hérité de ControlDesigner)
Behavior
Obsolète.

Obtient ou définit le comportement DHTML associé au concepteur.

(Hérité de HtmlControlDesigner)
CanConfigure

Obtient une valeur qui indique si la méthode Configure() peut être appelée.

CanRefreshSchema

Obtient une valeur qui indique si la méthode RefreshSchema(Boolean) peut être appelée.

Component

Obtient le composant qui est créé par ce concepteur.

(Hérité de ComponentDesigner)
DataBindings

Obtient la collection de liaisons de données pour le contrôle actuel.

(Hérité de HtmlControlDesigner)
DataBindingsEnabled

Obtient une valeur indiquant si la liaison de données est prise en charge par la zone conteneur du contrôle associé

(Hérité de ControlDesigner)
DesignerState

Obtient un objet qui est utilisé pour rendre persistantes les données du contrôle associé au moment du design.

(Hérité de ControlDesigner)
DesignTimeElement
Obsolète.

Obtient l'objet de design représentant le contrôle associé à l'objet HtmlControlDesigner sur l'aire de conception.

(Hérité de HtmlControlDesigner)
DesignTimeElementView
Obsolète.

Obtient l’objet de contrôle d’affichage du concepteur de contrôles.

(Hérité de ControlDesigner)
DesignTimeHtmlRequiresLoadComplete
Obsolète.

Obtient une valeur qui indique si l'hôte de conception doit terminer le chargement avant que la méthode GetDesignTimeHtml ne puisse être appelée.

(Hérité de ControlDesigner)
Expressions

Obtient les liaisons d'expressions pour le contrôle en cours au moment du design.

(Hérité de HtmlControlDesigner)
HidePropertiesInTemplateMode

Obtient une valeur indiquant si les propriétés du contrôle associé sont masquées lorsque le contrôle est en mode modèles.

(Hérité de ControlDesigner)
ID

Obtient ou définit la chaîne d'identification pour le contrôle.

(Hérité de ControlDesigner)
InheritanceAttribute

Obtient un attribut qui indique le type d'héritage du composant associé.

(Hérité de ComponentDesigner)
Inherited

Obtient une valeur indiquant si ce composant est hérité.

(Hérité de ComponentDesigner)
InTemplateMode

Obtient une valeur qui indique si le contrôle se trouve en mode d'affichage ou de modification de modèle dans l'hôte de conception. La propriété InTemplateMode est en lecture seule.

(Hérité de ControlDesigner)
IsDirty
Obsolète.

Obtient ou définit une valeur indiquant si le contrôle serveur Web a été signalé comme étant modifié.

(Hérité de ControlDesigner)
ParentComponent

Obtient le composant parent de ce concepteur.

(Hérité de ComponentDesigner)
ReadOnly
Obsolète.

Obtient ou définit une valeur qui indique si les propriétés du contrôle sont en lecture seule au moment du design.

(Hérité de ControlDesigner)
RootDesigner

Obtient le Concepteur de contrôles de la page Web Forms qui contient le contrôle associé.

(Hérité de ControlDesigner)
SetTextualDefaultProperty

Fournit la prise en charge au moment du design dans un hôte de conception pour la classe DataSourceControl.

(Hérité de ComponentDesigner)
ShadowProperties

Obtient une collection de valeurs de propriétés qui substituent les paramètres utilisateur.

(Hérité de ComponentDesigner)
ShouldCodeSerialize
Obsolète.

Obtient ou définit une valeur indiquant s'il faut créer une déclaration de champ pour le contrôle dans le fichier code-behind pour le document de design actuel pendant la sérialisation.

(Hérité de HtmlControlDesigner)
SuppressingDataSourceEvents

Obtient une valeur qui indique si l'événement DataSourceChanged ou la méthode RefreshSchema(Boolean) se produit.

Tag

Obtient un objet représentant l'élément de balisage HTML pour le contrôle associé.

(Hérité de ControlDesigner)
TemplateGroups

Obtient une collection de groupes de modèles, chacun contenant une ou plusieurs définitions de modèle.

(Hérité de ControlDesigner)
UsePreviewControl

Obtient une valeur indiquant si le concepteur de contrôles utilise un contrôle d’aperçu temporaire pour générer le balisage HTML au moment du design.

(Hérité de ControlDesigner)
Verbs

Obtient les verbes de design pris en charge par le composant associé au concepteur.

(Hérité de ComponentDesigner)
ViewControl

Obtient ou définit un contrôle serveur Web qui peut être utilisé pour afficher un aperçu du balisage HTML au moment du design.

(Hérité de ControlDesigner)
ViewControlCreated

Obtient ou définit une valeur qui indique si un contrôle View a été créé pour l'affichage sur l'aire de conception.

(Hérité de ControlDesigner)
Visible

Obtient une valeur qui indique si le contrôle est visible au moment de la conception.

(Hérité de ControlDesigner)

Méthodes

Configure()

Lance l'utilitaire de configuration de source de données dans l'hôte de conception.

CreateErrorDesignTimeHtml(String)

Crée le balisage HTML pour afficher un message d'erreur spécifié au moment du design.

(Hérité de ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)

Crée le balisage HTML pour afficher un message d'erreur d'exception spécifié au moment du design.

(Hérité de ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

Fournit une représentation d'espace réservé rectangulaire simple qui affiche le type et l'ID du contrôle.

(Hérité de ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

Fournit une représentation d'espace réservé rectangulaire simple qui affiche le type et l'ID du contrôle, ainsi que d'autres instructions ou informations spécifiées.

(Hérité de ControlDesigner)
CreateViewControl()

Retourne une copie du contrôle associé pour l'affichage ou le rendu sur l'aire de conception.

(Hérité de ControlDesigner)
Dispose()

Libère toutes les ressources utilisées par ComponentDesigner.

(Hérité de ComponentDesigner)
Dispose(Boolean)

Libère les ressources non managées utilisées par l'objet HtmlControlDesigner et libère éventuellement les ressources managées.

(Hérité de HtmlControlDesigner)
DoDefaultAction()

Crée une signature de méthode dans le fichier de code source de l'événement par défaut du composant et déplace le curseur de l'utilisateur jusqu'à cet emplacement.

(Hérité de ComponentDesigner)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetBounds()

Récupère les coordonnées du rectangle représentant les limites du contrôle affiché sur l'aire de conception.

(Hérité de ControlDesigner)
GetDesignTimeHtml()

Récupère le balisage HTML pour afficher le contrôle de source de données associé au moment du design.

GetDesignTimeHtml(DesignerRegionCollection)

Récupère le balisage HTML pour afficher le contrôle et remplit la collection avec les zones du Concepteur de contrôles actuelles.

(Hérité de ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)

Retourne le contenu d'une région modifiable de la vue au moment de la conception du contrôle associé.

(Hérité de ControlDesigner)
GetEmptyDesignTimeHtml()

Récupère le balisage HTML pour représenter un contrôle serveur web au moment du design qui n’aura aucune représentation visuelle au moment de l’exécution.

(Hérité de ControlDesigner)
GetErrorDesignTimeHtml(Exception)

Récupère le balisage HTML qui fournit des informations sur l’exception spécifiée.

(Hérité de ControlDesigner)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetPersistenceContent()

Récupère le balisage HTML interne persistable du contrôle au moment du design.

(Hérité de ControlDesigner)
GetPersistInnerHtml()
Obsolète.

Récupère le balisage HTML interne persistable du contrôle.

(Hérité de ControlDesigner)
GetService(Type)

Tente de récupérer le type spécifié de service du composant du concepteur du site en mode Design.

(Hérité de ComponentDesigner)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetView(String)

Récupère un objet DesignerDataSourceView identifié par le nom de vue.

GetViewNames()

Retourne un tableau des noms de vues disponibles dans cette source de données.

GetViewRendering()

Récupère un objet qui contient le balisage au moment du design pour le contenu et les zones du contrôle associé.

(Hérité de ControlDesigner)
Initialize(IComponent)

Initialise le Concepteur de contrôles et charge le composant spécifié.

(Hérité de ControlDesigner)
InitializeExistingComponent(IDictionary)

Réinitialise un composant existant.

(Hérité de ComponentDesigner)
InitializeNewComponent(IDictionary)

Initialise un composant nouvellement créé.

(Hérité de ComponentDesigner)
InitializeNonDefault()
Obsolète.
Obsolète.

Initialise les paramètres d'un composant importé qui est déjà initialisé pour utiliser des paramètres autres que ceux par défaut.

(Hérité de ComponentDesigner)
Invalidate()

Invalide la zone complète du contrôle affiché sur l'aire de conception et signale au Concepteur de contrôles qu'il doit redessiner le contrôle.

(Hérité de ControlDesigner)
Invalidate(Rectangle)

Invalide la zone spécifiée du contrôle affiché sur l'aire de conception et signale au Concepteur de contrôles qu'il doit redessiner le contrôle.

(Hérité de ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

Obtient le InheritanceAttribute du ComponentDesigner spécifié.

(Hérité de ComponentDesigner)
IsPropertyBound(String)
Obsolète.

Récupère une valeur indiquant si la propriété spécifiée sur le contrôle associé est liée aux données.

(Hérité de ControlDesigner)
Localize(IDesignTimeResourceWriter)

Utilise le writer de ressource fourni pour rendre persistantes les propriétés localisables du contrôle associé dans une ressource de l'hôte de conception.

(Hérité de ControlDesigner)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnAutoFormatApplied(DesignerAutoFormat)

Appelée lorsqu'un schéma de mise en forme automatique prédéfini a été appliqué au contrôle associé.

(Hérité de ControlDesigner)
OnBehaviorAttached()

Appelé quand le Concepteur de contrôles est attaché à un objet Behavior.

(Hérité de ControlDesigner)
OnBehaviorDetaching()
Obsolète.

Appelé lorsqu'un comportement se dissocie de l'élément.

(Hérité de HtmlControlDesigner)
OnBindingsCollectionChanged(String)
Obsolète.

Appelée lorsque la collection de liaisons de données change.

(Hérité de ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

Appelé par l'hôte de conception lorsque l'utilisateur clique sur le contrôle associé au moment du design.

(Hérité de ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)

Appelé lorsque le contrôle associé change.

(Hérité de ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

Représente la méthode qui gérera l'événement ComponentChanging pour le contrôle associé.

(Hérité de ControlDesigner)
OnControlResize()
Obsolète.

Appelé lorsque le contrôle serveur Web associé a été redimensionné dans l'hôte de conception au moment du design.

(Hérité de ControlDesigner)
OnDataSourceChanged(EventArgs)

Déclenche l'événement DataSourceChanged lorsque les propriétés de la source de données ont changé et que la valeur SuppressingDataSourceEvents est false.

OnPaint(PaintEventArgs)

Appelé lorsque le Concepteur de contrôles dessine le contrôle associé sur l'aire de conception, si la valeur CustomPaint est true.

(Hérité de ControlDesigner)
OnSchemaRefreshed(EventArgs)

Déclenche l'événement SchemaRefreshed lorsque le schéma de la source de données a changé et que la valeur SuppressingDataSourceEvents est false.

OnSetComponentDefaults()
Obsolète.
Obsolète.

Définit les propriétés par défaut du composant.

(Hérité de ComponentDesigner)
OnSetParent()

Offre un moyen d'effectuer un traitement supplémentaire lorsque le contrôle associé est attaché à un contrôle parent.

(Hérité de HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Permet à un concepteur de modifier ou de supprimer des éléments de l'ensemble d'attributs qu'il expose à l'aide d'un TypeDescriptor.

(Hérité de ComponentDesigner)
PostFilterEvents(IDictionary)

Permet à un concepteur de modifier ou de supprimer des éléments de l'ensemble d'événements à l'aide d'un TypeDescriptor.

(Hérité de ComponentDesigner)
PostFilterProperties(IDictionary)

Permet à un concepteur de modifier ou de supprimer des éléments de l'ensemble de propriétés qu'il expose à l'aide d'un TypeDescriptor.

(Hérité de ComponentDesigner)
PreFilterAttributes(IDictionary)

Permet à un concepteur d'ajouter des éléments à l'ensemble d'attributs qu'il expose à l'aide d'un TypeDescriptor.

(Hérité de ComponentDesigner)
PreFilterEvents(IDictionary)

Définit la liste des événements qui sont exposés au moment du design pour l'objet TypeDescriptor du composant.

(Hérité de HtmlControlDesigner)
PreFilterProperties(IDictionary)

Ajoute ou supprime des propriétés dans la grille Propriétés dans un hôte de conception au moment du design ou fournit des nouvelles propriétés au moment du design qui peuvent correspondre à des propriétés sur le contrôle associé.

(Hérité de ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)

Avertit le IComponentChangeService que ce composant a été modifié.

(Hérité de ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Avertit le IComponentChangeService que ce composant est sur le point d'être modifié.

(Hérité de ComponentDesigner)
RaiseResizeEvent()
Obsolète.

Déclenche l’événement OnControlResize().

(Hérité de ControlDesigner)
RefreshSchema(Boolean)

Actualise le schéma de la source de données, en supprimant éventuellement des événements.

RegisterClone(Object, Object)

Inscrit des données internes dans un contrôle cloné.

(Hérité de ControlDesigner)
ResumeDataSourceEvents()

Restaure les événements de source de données après que ceux-ci ont été supprimés.

SchemasEquivalent(IDataSourceSchema, IDataSourceSchema)

Fournit une valeur qui indique si deux schémas sont équivalents.

SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Spécifie le contenu pour une zone modifiable du contrôle au moment du design.

(Hérité de ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)

Spécifie le contenu d'une zone modifiable de la vue design du contrôle.

(Hérité de ControlDesigner)
SetViewFlags(ViewFlags, Boolean)

Assigne l'énumération ViewFlags de bits spécifiée à la valeur d'indicateur spécifiée.

(Hérité de ControlDesigner)
SuppressDataSourceEvents()

Diffère tous les événements de source de données jusqu'à l'appel de la méthode ResumeDataSourceEvents().

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
UpdateDesignTimeHtml()

Actualise le balisage HTML au moment du design du contrôle serveur Web associé en appelant la méthode GetDesignTimeHtml.

(Hérité de ControlDesigner)
ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema)

Fournit une valeur qui détermine si deux vues de schéma sont équivalentes.

Événements

DataSourceChanged

Se produit lorsqu'une propriété quelconque de la source de données associée est modifiée.

SchemaRefreshed

Se produit après l'actualisation du schéma.

Implémentations d’interfaces explicites

IDesignerFilter.PostFilterAttributes(IDictionary)

Pour obtenir une description de ce membre, consultez la méthode PostFilterAttributes(IDictionary).

(Hérité de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Pour obtenir une description de ce membre, consultez la méthode PostFilterEvents(IDictionary).

(Hérité de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Pour obtenir une description de ce membre, consultez la méthode PostFilterProperties(IDictionary).

(Hérité de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Pour obtenir une description de ce membre, consultez la méthode PreFilterAttributes(IDictionary).

(Hérité de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Pour obtenir une description de ce membre, consultez la méthode PreFilterEvents(IDictionary).

(Hérité de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Pour obtenir une description de ce membre, consultez la méthode PreFilterProperties(IDictionary).

(Hérité de ComponentDesigner)
ITreeDesigner.Children

Pour obtenir une description de ce membre, consultez la propriétéChildren.

(Hérité de ComponentDesigner)
ITreeDesigner.Parent

Pour obtenir une description de ce membre, consultez la propriétéParent.

(Hérité de ComponentDesigner)

S’applique à

Voir aussi