EditorPartDesigner 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.
Fournit une prise en charge au moment du design pour les contrôles EditorPart.
public ref class EditorPartDesigner : System::Web::UI::Design::WebControls::WebParts::PartDesigner
public class EditorPartDesigner : System.Web.UI.Design.WebControls.WebParts.PartDesigner
type EditorPartDesigner = class
inherit PartDesigner
Public Class EditorPartDesigner
Inherits PartDesigner
- Héritage
-
EditorPartDesigner
Exemples
L’exemple de code suivant crée un contrôle EditorPart personnalisé simple qui permet à l’utilisateur de modifier la propriété ToolTip du contrôle cible. Le EditorPartDesigner associé valide le contrôle et remplace la zone de texte d’entrée utilisateur au moment du design par une étiquette expliquant qu’elle est masquée.
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web.UI.Design.WebControls.WebParts;
/// <summary>
/// SecretEditorPart is a custom EditorPart control that
/// allows the end user to change the ToolTip property of
/// a control by typing the value into a TextBox.
/// SecretEditorPartDesigner hides the TextBox at design
/// time via the view control and replaces it with the
/// words "The textbox is now hidden."
/// </summary>
namespace Samples.AspNet.CS.Controls
{
[Designer(typeof(SecretEditorPartDesigner))]
public class SecretEditorPart : EditorPart
{
public CheckBox UseCustom = new CheckBox();
public TextBox TTTextBox = new TextBox();
protected override void CreateChildControls()
{
base.CreateChildControls();
Controls.Add(UseCustom);
Literal lApply = new Literal();
lApply.Text = "Apply custom ToolTip<br />";
Controls.Add(lApply);
Controls.Add(TTTextBox);
}
public override bool ApplyChanges()
{
EnsureChildControls();
try
{
WebPartToEdit.ToolTip = TTTextBox.Text;
}
catch
{
return false;
}
return true;
}
public override void SyncChanges()
{
// Abstract method not implemented for this example
return;
}
}
public class SecretEditorPartDesigner : EditorPartDesigner
{
public override void Initialize(IComponent component)
{
// Validate the associated control
if (! (component is SecretEditorPart))
{
string msg = "The associated control must be of type 'SecretEditorPart'";
throw new ArgumentException(msg);
}
base.Initialize(component);
}
public override string GetDesignTimeHtml()
{
// Access the view control.
SecretEditorPart sep = (SecretEditorPart)ViewControl;
// Hide the textbox.
sep.TTTextBox.Visible = false;
// Now generate the base rendering.
string designTimeHtml = base.GetDesignTimeHtml();
// Insert some text.
string segment = "</div>";
designTimeHtml = designTimeHtml.Replace(segment,
"The textbox is now hidden." + segment);
// Return the modified rendering.
return designTimeHtml;
}
}
}
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Web.UI.Design.WebControls.WebParts
' SecretEditorPart is a custom EditorPart control that
' allows the end user to change the ToolTip property of
' a control by typing the value into a TextBox.
' SecretEditorPartDesigner hides the TextBox at design
' time via the view control and replaces it with the
' words "The textbox is now hidden."
Namespace Samples.AspNet.VB.Controls
<Designer(GetType(SecretEditorPartDesigner))> _
Public Class SecretEditorPart
Inherits EditorPart
Public UseCustom As New CheckBox()
Public TTTextBox As New TextBox()
Protected Overrides Sub CreateChildControls()
MyBase.CreateChildControls()
Controls.Add(UseCustom)
Dim lApply As New Literal()
lApply.Text = "Apply custom ToolTip<br />"
Controls.Add(lApply)
Controls.Add(TTTextBox)
End Sub
Public Overrides Function ApplyChanges() As Boolean
EnsureChildControls()
Try
WebPartToEdit.ToolTip = TTTextBox.Text
Catch
Return False
End Try
Return True
End Function
Public Overrides Sub SyncChanges()
' Abstract method not implemented for this example
Return
End Sub
End Class
Public Class SecretEditorPartDesigner
Inherits EditorPartDesigner
Public Overrides Sub Initialize(component As IComponent)
' Validate the associated control
If Not (TypeOf component Is SecretEditorPart) Then
Dim msg As String = "The associated control must be of type 'SecretEditorPart'"
Throw New ArgumentException(msg)
End If
MyBase.Initialize(component)
End Sub
Public Overrides Function GetDesignTimeHtml() As String
' Access the view control.
Dim sep As SecretEditorPart = DirectCast(ViewControl, SecretEditorPart)
' Hide the textbox.
sep.TTTextBox.Visible = False
' Now generate the base rendering.
Dim designTimeHtml As String = MyBase.GetDesignTimeHtml()
' Insert some text.
Dim segment As String = "</div>"
designTimeHtml = designTimeHtml.Replace(segment, "The textbox is now hidden." & segment)
' Return the modified rendering.
Return designTimeHtml
End Function
End Class
End Namespace
Pour que le contrôle personnalisé soit affiché, la page doit avoir un contrôle WebPartManager, un EditorZone avec un ZoneTemplate pour que le contrôle réside, et un WebPartZone contenant un contrôle pour l'EditorPart personnalisé sur lequel agir, comme illustré dans l’exemple de code suivant.
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<%@ Register TagPrefix="ccl" Namespace="Samples.AspNet.CS.Controls" %>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>EditorPartDesigner Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" runat="server">
</asp:WebPartManager><br />
<asp:EditorZone ID="EditorZone1" runat="server" Enabled="true" >
<ZoneTemplate>
<ccl:SecretEditorPart ID="SEPart1" runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:Button ID="Button1" runat="server" Height="24px" Text="Button" />
</ZoneTemplate>
</asp:WebPartZone><br />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="true" CodeFile="Default.aspx.vb" Inherits="_Default" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<%@ Register TagPrefix="ccl" Namespace="Samples.AspNet.VB.Controls" %>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>EditorPartDesigner Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" runat="server">
</asp:WebPartManager><br />
<asp:EditorZone ID="EditorZone1" runat="server" Enabled="true" >
<ZoneTemplate>
<ccl:SecretEditorPart ID="SEPart1" runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:Button ID="Button1" runat="server" Height="24px" Text="Button" />
</ZoneTemplate>
</asp:WebPartZone><br />
</div>
</form>
</body>
</html>
Pour que le EditorPart soit utilisable au moment de l’exécution, le mode d’édition doit être activé sur la page. L’exemple de code suivant montre comment procéder avec un fichier code-behind.
using System;
using System.Web.UI.WebControls.WebParts;
public partial class _Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
{
// Make the 'Edit' verb available so the EditorZone can render
WebPartManager mgr = WebPartManager.GetCurrentWebPartManager(Page);
mgr.DisplayMode = mgr.SupportedDisplayModes["Edit"];
}
}
}
Imports System.Web.UI.WebControls.WebParts
Public Partial Class _Default
Inherits System.Web.UI.Page
Protected Sub Page_Load(sender As Object, e As EventArgs)
If True Then
' Make the 'Edit' verb available so the EditorZone can render
Dim mgr As WebPartManager = WebPartManager.GetCurrentWebPartManager(Page)
mgr.DisplayMode = mgr.SupportedDisplayModes("Edit")
End If
End Sub
End Class
Remarques
EditorPartDesigner est une implémentation publique de la classe de base PartDesigner pour le rendu des contrôles EditorPart au moment du design. Il ajoute la fonctionnalité de transport d’informations de zone du contrôle associé en mode Création, mais ne modifie pas autrement les fonctionnalités du contrôle parent.
Comme avec d’autres concepteurs de contrôles, vous pouvez modifier le rendu au moment du design des contrôles de EditorPart personnalisés en héritent de EditorPartDesigner et en substituant la méthode GetDesignTimeHtml. Si vous souhaitez remplacer la méthode CreateViewControl, veillez à inclure l’implémentation de base afin de conserver les informations de zone.
Constructeurs
EditorPartDesigner() |
Initialise une nouvelle instance de la classe EditorPartDesigner. |
Propriétés
ActionLists |
Obtient la collection de listes d’actions pour le concepteur de contrôles. (Hérité de ControlDesigner) |
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 format automatique |
Behavior |
Obsolète.
Obtient ou définit le comportement DHTML associé au concepteur. (Hérité de HtmlControlDesigner) |
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 la liaison de données est prise en charge par la région conteneur du contrôle associé. (Hérité de ControlDesigner) |
DesignerState |
Obtient un objet utilisé pour conserver les données du contrôle associé au moment du design. (Hérité de ControlDesigner) |
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 |
Obsolète.
Obtient une valeur indiquant si l’hôte de conception doit terminer le chargement avant que la méthode GetDesignTimeHtml puisse être appelée. (Hérité de ControlDesigner) |
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 associé sont masquées lorsque le contrôle est en mode modèle. (Hérité de ControlDesigner) |
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 |
Obtient une valeur indiquant si le contrôle est en mode d’affichage ou d’édition 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é 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) |
SetTextualDefaultProperty |
Fournit une prise en charge au moment du design pour les contrôles EditorPart. (Hérité de ComponentDesigner) |
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 ou plusieurs définitions de modèle. (Hérité de ControlDesigner) |
UsePreviewControl |
Obtient une valeur indiquant si le concepteur doit utiliser une copie temporaire plutôt que le contrôle réel associé au concepteur pour générer le balisage au moment du design. (Hérité de PartDesigner) |
Verbs |
Obtient les verbes au moment du design pris en charge par le composant associé au concepteur. (Hérité de ComponentDesigner) |
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 contrôle |
Visible |
Obtient une valeur qui indique si le contrôle est visible au moment du design. (Hérité de ControlDesigner) |
Méthodes
CreateChildControls() |
Crée les contrôles enfants de ce contrôle CompositeControl. (Hérité de CompositeControlDesigner) |
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) |
CreateViewControl() |
Crée une copie du contrôle EditorPart associé à afficher au moment du design. |
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 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 pour l’événement par défaut sur le composant et accède au curseur de l’utilisateur à 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, comme indiqué sur l’aire de conception. (Hérité de ControlDesigner) |
GetDesignTimeHtml() |
Vérifie que le contrôle réside dans une zone de type EditorZoneBase, puis obtient le balisage utilisé pour représenter le contrôle au moment du 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() |
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() |
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() |
Obsolète.
Récupère le balisage HTML interne persistant du contrôle. (Hérité de ControlDesigner) |
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) |
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) |
Lie le concepteur au contrôle EditorPart associé. |
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 la InheritanceAttribute du ComponentDesignerspé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 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) |
OnAutoFormatApplied(DesignerAutoFormat) |
Appelé 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é lorsque le concepteur de contrôles est attaché à un objet Behavior. (Hérité de ControlDesigner) |
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) |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Appelé lorsque le contrôle associé change. (Hérité de ControlDesigner) |
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) |
OnPaint(PaintEventArgs) |
Appelé lorsque le concepteur de contrôles dessine le contrôle associé sur l’aire de conception, si la valeur CustomPaint est |
OnSetComponentDefaults() |
Obsolète.
Obsolète.
Définit les propriétés par défaut du composant. (Hérité de ComponentDesigner) |
OnSetParent() |
Fournit 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 via 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 via 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 via 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) |
Ajoute ou supprime des propriétés de la grille Propriétés dans un hôte de conception au moment du design ou fournit de nouvelles propriétés au moment du design qui peuvent correspondre aux propriétés du 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) |
RegisterClone(Object, Object) |
Inscrit des données internes dans un contrôle cloné. (Hérité de ControlDesigner) |
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) |
SetViewFlags(ViewFlags, Boolean) |
Affecte l’énumération ViewFlags au niveau du bit spécifié à 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() |
Actualise le balisage HTML au moment du design pour le contrôle serveur Web associé en appelant la méthode GetDesignTimeHtml. (Hérité de ControlDesigner) |
Implémentations d’interfaces explicites
S’applique à
Voir aussi
- ControlDesigner
- EditorPart
- WebPartDesigner
- contrôles de composants WebPart ASP.NET
- Vue d’ensemble ASP.NET Concepteurs de contrôles