DataGridDesigner Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Étend le comportement au moment du design pour le DataGrid contrôle serveur Web.
public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesignerpublic class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesignertype DataGridDesigner = class
inherit BaseDataListDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
inherit BaseDataListDesignerPublic Class DataGridDesigner
Inherits BaseDataListDesigner- Héritage
- Attributs
Exemples
L’exemple de code suivant montre comment étendre la DataGridDesigner classe. Le code remplace la GetDesignTimeHtml méthode pour personnaliser les propriétés et CellPaddingBorderWidth les BorderColorpropriétés lorsque le DataGrid contrôle est rendu sur une surface de conception.
Imports System.Diagnostics
Imports System.ComponentModel
Imports System.Drawing
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace Examples.AspNet
' Create a designer class for the SimpleDataList class.
<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.Demand, _
Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Class SimpleDataListDesigner
Inherits DataListDesigner
Private simpleList As SimpleDataList
' Override the GetDesignTimeHtml method to add style to the control
' on the design surface.
Public Overrides Function GetDesignTimeHtml() As String
' Cast the control to the Component property of the designer.
simpleList = CType(Component, SimpleDataList)
Dim designTimeHtml As String = Nothing
' Create variables to hold current property values.
Dim oldBorderWidth As Unit = simpleList.BorderWidth
Dim oldBorderColor As Color = simpleList.BorderColor
' Set the properties and generate the design-time HTML.
If (simpleList.Enabled) Then
Try
simpleList.BorderWidth = Unit.Point(5)
simpleList.BorderColor = Color.Purple
designTimeHtml = MyBase.GetDesignTimeHtml()
' Call the GetErrorDesignTimeHtml method if an
' exception occurs.
Catch ex As Exception
designTimeHtml = GetErrorDesignTimeHtml(ex)
' Return the properties to their original settings.
Finally
simpleList.BorderWidth = oldBorderWidth
simpleList.BorderColor = oldBorderColor
End Try
' If the list is not enabled, call the GetEmptyDesignTimeHtml
' method.
Else
designTimeHtml = GetEmptyDesignTimeHtml()
End If
Return designTimeHtml
End Function
Protected Overrides Function GetEmptyDesignTimeHtml() As String
Dim emptyText As String
' Check the CanEnterTemplateMode property to
' specify which text to display if ItemTemplate
' does not contain a value.
If CanEnterTemplateMode Then
emptyText = _
"<b>Either the Enabled property value is false " + _
"or you need to set the ItemTemplate for this " + _
"control.<br>Right-click to edit templates.</b>"
Else
emptyText = _
"<b>You cannot edit templates in this view.<br>" + _
"Switch to HTML view to define the ItemTemplate.</b>"
End If
Return CreatePlaceHolderDesignTimeHtml(emptyText)
End Function
' Generate HTML to indicate that an error has occurred.
Protected Overrides Function GetErrorDesignTimeHtml(ByVal exc As _
Exception) As String
Return CreatePlaceHolderDesignTimeHtml( _
"<b>An error occurred</b>.<br>Check to ensure that all " + _
"properties are valid.")
End Function
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
End Class
End Namespace
L’exemple suivant montre comment utiliser l’attribut DesignerAttribute pour associer le concepteur au DataGrid contrôle.
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
Constructeurs
| Nom | Description |
|---|---|
| DataGridDesigner() |
Initialise une nouvelle instance de la classe DataGridDesigner. |
Propriétés
| Nom | Description |
|---|---|
| ActionLists |
Obtient la collection de listes d’actions du concepteur pour ce concepteur. (Hérité de BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
Obsolète.
Obtient le cadre d’édition de modèle actif. (Hérité de TemplatedControlDesigner) |
| 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 l’objet DesignerAutoFormatCollection associé à ce concepteur. |
| Behavior |
Obsolète.
Obtient ou définit le comportement DHTML associé au concepteur. (Hérité de HtmlControlDesigner) |
| CanEnterTemplateMode |
Obtient une valeur indiquant si ce concepteur autorise ou non l’affichage ou la modification de modèles. (Hérité de TemplatedControlDesigner) |
| Component |
Obtient le composant que ce concepteur conçoit. (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 le concepteur autorise la liaison de données. (Hérité de TemplatedControlDesigner) |
| DataKeyField |
Obtient ou définit la valeur du champ clé de données du contrôle associé. (Hérité de BaseDataListDesigner) |
| DataMember |
Obtient ou définit la valeur du champ membre de données du contrôle associé. (Hérité de BaseDataListDesigner) |
| DataSource |
Obtient ou définit la valeur de la propriété source de données du contrôle associé. (Hérité de BaseDataListDesigner) |
| DataSourceDesigner |
Obtient le concepteur de la source de données, lorsqu’il est sélectionné pour la liaison de données. (Hérité de BaseDataListDesigner) |
| DataSourceID |
Obtient ou définit la version du concepteur de la propriété ID de source de données et est utilisée pour masquer la propriété correspondante du contrôle associé. (Hérité de BaseDataListDesigner) |
| DesignerState |
Obtient un objet utilisé pour conserver les données du contrôle associé au moment du design. (Hérité de ControlDesigner) |
| DesignerView |
Obtient la vue par défaut de la source de données liée au contrôle associé. (Hérité de BaseDataListDesigner) |
| DesignTimeElement |
Obsolète.
Obtient l’objet au moment du 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 pour le concepteur de contrôles. (Hérité de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obtient une valeur indiquant si le chargement doit être terminé pour afficher le balisage au moment du design. (Hérité de BaseDataListDesigner) |
| Expressions |
Obtient les liaisons d’expression pour le contrôle actuel au moment du design. (Hérité de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Obtient une valeur indiquant si les propriétés du contrôle seront masquées lorsque le contrôle est placé en mode d’édition de modèle. (Hérité de TemplatedControlDesigner) |
| ID |
Obtient ou définit la chaîne d’ID du 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 |
Obsolète.
Obtient une valeur indiquant si le document du concepteur est en mode modèle. (Hérité de TemplatedControlDesigner) |
| IsDirty |
Obsolète.
Obtient ou définit une valeur indiquant si le contrôle serveur Web a été marqué comme 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 indiquant 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) |
| ShadowProperties |
Obtient une collection de valeurs de propriété qui remplacent 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 du document de conception actuel lors de la sérialisation. (Hérité de HtmlControlDesigner) |
| 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, chacune contenant une définition de modèle. (Hérité de TemplatedControlDesigner) |
| 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 la collection de verbes disponibles pour ce concepteur. (Hérité de BaseDataListDesigner) |
| ViewControl |
Obtient ou définit un contrôle de 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 indiquant si un |
| Visible |
Obtient une valeur qui indique si le contrôle est visible au moment du design. (Hérité de ControlDesigner) |
Méthodes
| Nom | Description |
|---|---|
| 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) |
| CreateErrorDesignTimeHtml(String) |
Crée un balisage HTML pour afficher un message d’erreur 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 des instructions ou des informations spécifiées supplémentaires. (Hérité de ControlDesigner) |
| CreateTemplateEditingFrame(TemplateEditingVerb) |
Obsolète.
Crée un cadre d’édition de modèle à l’aide du verbe spécifié. |
| 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 le ComponentDesigner. (Hérité de ComponentDesigner) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par l’objet DataGridDesigner et libère éventuellement les ressources managées. |
| DoDefaultAction() |
Crée une signature de méthode dans le fichier de code source pour l’événement par défaut sur le composant et accède au curseur de l’utilisateur à cet emplacement. (Hérité de ComponentDesigner) |
| EnterTemplateMode(ITemplateEditingFrame) |
Obsolète.
Ouvre un objet frame de modèle particulier pour la modification dans le concepteur. (Hérité de TemplatedControlDesigner) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| ExitTemplateMode(Boolean, Boolean, Boolean) |
Obsolète.
Ferme le cadre d’édition de modèle actif après avoir enregistré les modifications pertinentes. (Hérité de TemplatedControlDesigner) |
| GetBounds() |
Récupère les coordonnées du rectangle représentant les limites du contrôle, comme indiqué sur l’aire de conception. (Hérité de ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Obsolète.
Obtient les verbes de modification de modèle mis en cache disponibles pour le concepteur. |
| GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Génère un objet qui peut être utilisé comme source de données au moment du design. (Hérité de BaseDataListDesigner) |
| GetDesignTimeDataSource(Int32, Boolean) |
Génère un objet qui peut être utilisé comme source de données au moment du design. (Hérité de BaseDataListDesigner) |
| GetDesignTimeHtml() |
Obtient le balisage HTML utilisé pour représenter le contrôle au moment du DataGrid design. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Récupère le balisage HTML pour afficher le contrôle et remplir la collection avec les régions du concepteur de contrôles actuelles. (Hérité de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Retourne le contenu d’une région modifiable de l’affichage au moment du design du contrôle associé. (Hérité de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Obtient le balisage HTML utilisé pour représenter un contrôle basé sur un modèle vide au moment du design. |
| GetErrorDesignTimeHtml(Exception) |
Obtient le balisage HTML affiché au moment du design pour l’exception spécifiée lorsqu’une erreur a été rencontrée lors du rendu du contrôle. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetPersistenceContent() |
Récupère le balisage HTML interne persistant du contrôle au moment du design. (Hérité de ControlDesigner) |
| GetPersistInnerHtml() |
Obtient le balisage à conserver pour le contenu qui se trouve dans le runtime de contrôle serveur associé. (Hérité de TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Obtient le composant de source de données du conteneur de contrôle associé, résolu en membre de données spécifique. (Hérité de BaseDataListDesigner) |
| GetSelectedDataSource() |
Obtient le composant de source de données du conteneur de contrôle associé. (Hérité de BaseDataListDesigner) |
| GetService(Type) |
Tente de récupérer le type de service spécifié à partir du site en mode conception du composant du concepteur. (Hérité de ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Obsolète.
Obtient la propriété d’élément de données du conteneur de modèle. |
| GetTemplateContainerDataSource(String) |
Obsolète.
Obtient la source de données du conteneur du modèle. (Hérité de BaseDataListDesigner) |
| GetTemplateContent(ITemplateEditingFrame, String, Boolean) |
Obsolète.
Obtient le contenu du modèle. |
| GetTemplateEditingVerbs() |
Obsolète.
Obtient les verbes de modification de modèle disponibles pour le concepteur. (Hérité de TemplatedControlDesigner) |
| GetTemplateFromText(String) |
Crée un modèle à partir du texte spécifié. (Hérité de TemplatedControlDesigner) |
| GetTemplatePropertyParentType(String) |
Obsolète.
Obtient l’objet Type correspondant au parent du modèle spécifié. |
| GetTextFromTemplate(ITemplate) |
Obtient une chaîne de texte qui représente le modèle spécifié. (Hérité de TemplatedControlDesigner) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetViewRendering() |
Récupère un objet qui contient le balisage au moment du design pour le contenu et les régions du contrôle associé. (Hérité de ControlDesigner) |
| Initialize(IComponent) |
Initialise le concepteur avec le contrôle spécifié DataGrid . |
| 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é dans des paramètres autres que les paramètres par défaut. (Hérité de ComponentDesigner) |
| Invalidate() |
Invalide toute la zone du contrôle affichée sur l’aire de conception et signale au concepteur de contrôles de redessiner le contrôle. (Hérité de ControlDesigner) |
| Invalidate(Rectangle) |
Invalide la zone spécifiée du contrôle affichée sur l’aire de conception et signale au concepteur de contrôles de redessiner le contrôle. (Hérité de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtient le InheritanceAttributeComponentDesigner. (Hérité de ComponentDesigner) |
| InvokePropertyBuilder(Int32) |
Appelle un éditeur de composant pour le contrôle associé. (Hérité de BaseDataListDesigner) |
| 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 l’enregistreur de ressources fourni pour conserver les propriétés localisables du contrôle associé à une ressource dans l’hôte de conception. (Hérité de ControlDesigner) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnAutoFormat(Object, EventArgs) |
Obsolète.
Gère l’événement |
| OnAutoFormatApplied(DesignerAutoFormat) |
Appelé lorsqu’un schéma de mise en forme automatique a été appliqué au contrôle associé. (Hérité de BaseDataListDesigner) |
| OnBehaviorAttached() |
Obsolète.
Offre la possibilité d’effectuer un traitement supplémentaire lorsqu’un comportement est attaché au concepteur. (Hérité de TemplatedControlDesigner) |
| OnBehaviorDetaching() |
Obsolète.
Appelé lorsqu’un comportement dissocie de l’élément. (Hérité de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsolète.
Appelé 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) |
| OnColumnsChanged() |
Appelé lorsque les colonnes du modèle changent. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Appelé lorsqu’il existe une modification du contrôle associé. (Hérité de BaseDataListDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Représente la méthode qui gère 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() |
Appelé lorsque la source de données du contrôle associé a changé. (Hérité de BaseDataListDesigner) |
| OnPaint(PaintEventArgs) |
Appelé lorsque le concepteur de contrôles dessine le contrôle associé sur l’aire de conception, si la CustomPaint valeur est |
| OnPropertyBuilder(Object, EventArgs) |
Représente la méthode qui gère l’événement du générateur de propriétés. (Hérité de BaseDataListDesigner) |
| OnSchemaRefreshed() |
Appelé lorsque le schéma de la source de données pour le contrôle associé change. (Hérité de BaseDataListDesigner) |
| OnSetComponentDefaults() |
Obsolète.
Obsolète.
Définit les propriétés par défaut du composant. (Hérité de ComponentDesigner) |
| OnSetParent() |
Permet d’effectuer un traitement supplémentaire lorsque le parent de ce concepteur est modifié. (Hérité de TemplatedControlDesigner) |
| OnStylesChanged() |
Peut être substitué pour implémenter des fonctionnalités qui doivent se produire lorsqu’un style du contrôle associé a changé. (Hérité de BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Appelé lorsque le modèle modifie les verbes change. |
| OnTemplateModeChanged() |
Offre la possibilité d’effectuer un traitement supplémentaire lorsque le mode modèle est modifié. (Hérité de TemplatedControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble d’attributs qu’il expose par le biais 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 qu’il expose par le biais 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 par le biais d’un TypeDescriptor. (Hérité de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permet à un concepteur d’ajouter à l’ensemble d’attributs qu’il expose par le biais d’un TypeDescriptor. (Hérité de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Définit la liste des événements exposés au moment du design pour l’objet TypeDescriptor du composant. (Hérité de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Utilisé par le concepteur pour supprimer des propriétés ou ajouter des propriétés supplémentaires à l’affichage dans la grille Propriétés ou pour masquer les propriétés du contrôle associé. (Hérité de BaseDataListDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Avertit que IComponentChangeService ce composant a été modifié. (Hérité de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Avertit que IComponentChangeService 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) |
| RegisterClone(Object, Object) |
Inscrit des données internes dans un contrôle cloné. (Hérité de ControlDesigner) |
| SaveActiveTemplateEditingFrame() |
Enregistre le cadre d’édition de modèle actif. (Hérité de TemplatedControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Spécifie le contenu d’une région modifiable du contrôle au moment du design. (Hérité de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Spécifie le contenu d’une région modifiable dans l’affichage au moment du design du contrôle. (Hérité de ControlDesigner) |
| SetTemplateContent(ITemplateEditingFrame, String, String) |
Obsolète.
Définit le contenu du modèle et du cadre spécifiés. |
| SetViewFlags(ViewFlags, Boolean) |
Affecte l’énumération au niveau ViewFlags du bit spécifiée à la valeur d’indicateur spécifiée. (Hérité de ControlDesigner) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| UpdateDesignTimeHtml() |
Met à jour le code HTML au moment du design. (Hérité de TemplatedControlDesigner) |
