EditorZone 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.
Sert de contrôle principal dans le jeu de contrôles WebPart pour l’hébergement de contrôles EditorPart sur une page web.
public ref class EditorZone : System::Web::UI::WebControls::WebParts::EditorZoneBasepublic class EditorZone : System.Web.UI.WebControls.WebParts.EditorZoneBasetype EditorZone = class
inherit EditorZoneBasePublic Class EditorZone
Inherits EditorZoneBase- Héritage
Exemples
L’exemple de code suivant illustre plusieurs utilisations déclaratives et programmatiques de la EditorZone classe . L’exemple crée une zone d’éditeur personnalisée qui hérite de la EditorZone classe et l’utilise dans une page de composants WebPart.
L’exemple de code comporte trois parties :
Contrôle utilisateur qui vous permet de modifier les modes d’affichage sur la page Web.
Page web qui fait référence au contrôle personnalisé EditorZone .
Explication du fonctionnement de l’exemple.
La première partie de cet exemple de code est le contrôle utilisateur qui permet aux utilisateurs de modifier les modes d’affichage sur une page Web. Pour plus d’informations sur les modes d’affichage et une description du code source dans ce contrôle, consultez Procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.
<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
// Use a field to reference the current WebPartManager.
WebPartManager _manager;
void Page_Init(object sender, EventArgs e)
{
Page.InitComplete += new EventHandler(InitComplete);
}
void InitComplete(object sender, System.EventArgs e)
{
_manager = WebPartManager.GetCurrentWebPartManager(Page);
String browseModeName = WebPartManager.BrowseDisplayMode.Name;
// Fill the dropdown with the names of supported display modes.
foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
{
String modeName = mode.Name;
// Make sure a mode is enabled before adding it.
if (mode.IsEnabled(_manager))
{
ListItem item = new ListItem(modeName + " Mode", modeName);
DisplayModeDropdown.Items.Add(item);
}
}
}
// Change the page to the selected display mode.
void DisplayModeDropdown_SelectedIndexChanged(object sender,
EventArgs e)
{
String selectedMode = DisplayModeDropdown.SelectedValue;
WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
if (mode != null)
_manager.DisplayMode = mode;
}
void Page_PreRender(object sender, EventArgs e)
{
DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
}
</script>
<div>
<asp:DropDownList ID="DisplayModeDropdown"
runat="server"
AutoPostBack="true"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName + " Mode", modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name
End Sub
</script>
<div>
<asp:DropDownList ID="DisplayModeDropdown"
runat="server"
AutoPostBack="true"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>
La deuxième partie de l’exemple de code est une page Web. En haut de la page se trouve une Register directive pour le contrôle utilisateur. La balise de contrôle utilisateur est déclarée dans la page avec un uc1: préfixe pour l’élément . Notez que sous l’élément <asp:WebPartZone> se trouve un <asp:EditorZone> élément qui contient plusieurs EditorPart contrôles, avec certaines balises et propriétés définies pour déterminer son apparence et son comportement. Il existe également un certain nombre de méthodes qui accèdent par programmation à différents membres du EditorZone contrôle.
<%@ Page Language="C#" %>
<%@ register tagprefix="uc1"
tagname="DisplayModeMenuCS"
src="displaymodecs.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3>
void Button1_Click(object sender, EventArgs e)
{
if (EditorZone1.ApplyVerb.Enabled == true)
EditorZone1.ApplyVerb.Enabled = false;
else
EditorZone1.ApplyVerb.Enabled = true;
}
void Button2_Click(object sender, EventArgs e)
{
EditorZone1.BorderWidth = 2;
EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
}
void Button3_Click(object sender, EventArgs e)
{
Label1.Text = "<br />";
foreach (EditorPart part in EditorZone1.EditorParts)
{
Label1.Text += part.ID + "<br />";
}
}
void Button4_Click(object sender, EventArgs e)
{
EditorZone1.InstructionText = "My custom instruction text.";
}
// </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>EditorZoneBase Examples</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="mgr" runat="server" />
<uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links" >
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
<asp:EditorZone ID="EditorZone1" runat="server" >
<VerbStyle Font-Italic="true" />
<EditUIStyle BackColor="lightgray" />
<PartChromeStyle BorderWidth="1" />
<LabelStyle Font-Bold="true" />
<CancelVerb Text="Cancel Changes" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<hr />
<asp:Button ID="Button1" runat="server" Width="200"
Text="Enable or Disable Apply" OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" runat="server" Width="200"
Text="Set Zone BorderColor" OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" runat="server" Width="200"
Text="Display EditorPart Collection" OnClick="Button3_Click" />
<asp:Label ID="Label1" runat="server" />
<br />
<asp:Button ID="Button4" runat="server" Width="200"
Text="Set Instruction Text" OnClick="Button4_Click" />
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1"
tagname="DisplayModeMenuVB"
src="displaymodevb.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' <snippet3>
Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
If EditorZone1.ApplyVerb.Enabled = True Then
EditorZone1.ApplyVerb.Enabled = False
Else
EditorZone1.ApplyVerb.Enabled = True
End If
End Sub
Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
EditorZone1.BorderWidth = 2
EditorZone1.BorderColor = System.Drawing.Color.DarkBlue
End Sub
Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
Label1.Text = "<br />"
Dim part As EditorPart
For Each part In EditorZone1.EditorParts
Label1.Text += part.ID + "<br />"
Next part
End Sub
Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
EditorZone1.InstructionText = "My custom instruction text."
End Sub
' </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>EditorZoneBase Examples</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="mgr" runat="server" />
<uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links" >
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
<asp:EditorZone ID="EditorZone1" runat="server" >
<VerbStyle Font-Italic="true" />
<EditUIStyle BackColor="lightgray" />
<PartChromeStyle BorderWidth="1" />
<LabelStyle Font-Bold="true" />
<CancelVerb Text="Cancel Changes" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<hr />
<asp:Button ID="Button1" runat="server" Width="200"
Text="Enable or Disable Apply" OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" runat="server" Width="200"
Text="Set Zone BorderColor" OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" runat="server" Width="200"
Text="Display EditorPart Collection" OnClick="Button3_Click" />
<asp:Label ID="Label1" runat="server" />
<br />
<asp:Button ID="Button4" runat="server" Width="200"
Text="Set Instruction Text" OnClick="Button4_Click" />
</form>
</body>
</html>
Lorsque vous chargez la page dans un navigateur, vous pouvez sélectionner Mode d’édition dans la liste déroulante pour passer en mode édition. Pour afficher l’interface utilisateur d’édition, vous pouvez cliquer sur le menu verbes (flèche vers le bas) dans la barre de titre de l’un des deux contrôles, puis cliquer sur Modifier pour modifier le contrôle. Une fois l’interface utilisateur d’édition visible, vous pouvez voir les effets des utilisations déclaratives et programmatiques des membres de la EditorZone classe.
Remarques
Dans le jeu de contrôles WebPart, une zone est un contrôle composite qui couvre une région définie sur une page Web et contient des contrôles serveur. Les principales fonctions d’une zone sont de disposer les contrôles qu’elle contient et de fournir une interface utilisateur commune pour ces contrôles. Pour obtenir des informations générales sur les zones et leur utilisation dans les applications WebPart, consultez la documentation de référence pour la classe de base WebZone et la vue d’ensemble du jeu de contrôles WebPart.
Le EditorZone contrôle est l’un des contrôles fondamentaux de l’ensemble de contrôles WebPart. Une fonctionnalité clé des composants WebPart est la possibilité pour les utilisateurs finaux de modifier (ou de personnaliser) les pages Web en fonction de leurs préférences et d’enregistrer leurs paramètres personnalisés pour les futures sessions de navigateur. L’un des aspects de la modification des pages de composants WebPart inclut la modification ; les utilisateurs peuvent modifier l’apparence, la disposition, le comportement et d’autres propriétés des contrôles visibles WebPart . Plusieurs contrôles dans le jeu de contrôles WebPart fournissent les fonctionnalités d’édition, y compris le EditorZone contrôle.
Un EditorZone contrôle devient visible lorsqu’une page de composants WebPart passe en mode édition et met à disposition différents EditorPart contrôles qui peuvent être utilisés pour personnaliser WebPart les contrôles. Le EditorZone contrôle est très similaire à son parent, la EditorZoneBase classe, avec une différence clé : le EditorZone contrôle fournit un modèle de zone, référencé dans sa ZoneTemplate propriété. Le modèle de zone ajoute la possibilité de déclarer du contenu au format de persistance de page. Les développeurs de pages peuvent placer un EditorZone contrôle dans le balisage déclaratif d’une page Web, ajouter un élément enfant <zonetemplate> et, dans l’élément <zonetemplate> , ajouter des références déclaratives aux EditorPart contrôles.
Le EditorZone contrôle a également une méthode, CreateEditorParts, qui remplace une méthode de base dans la EditorZoneBase classe . Cette méthode est nécessaire pour qu’un EditorZone contrôle puisse créer le modèle de zone pour contenir tous EditorPart les contrôles ajoutés à la zone de manière déclarative.
Notes
Les boutons de l’interface EditorZone utilisateur nécessitent un script côté client pour fonctionner correctement. Si l’écriture de scripts est désactivée dans le navigateur, l’utilisateur ne peut pas effectuer d’actions via l’interface EditorZone utilisateur.
Accessibilité
Le balisage rendu par défaut pour ce contrôle peut ne pas être conforme aux normes d’accessibilité, telles que les directives de priorité 1.0 des règles d’accessibilité du contenu web (WCAG). Pour plus d’informations sur la prise en charge de l’accessibilité pour ce contrôle, consultez ASP.NET Contrôles et accessibilité.
Notes pour les héritiers
Si vous souhaitez créer une zone personnalisée EditorZone pour mieux contrôler le rendu de l’interface utilisateur d’édition, vous pouvez hériter directement de la EditorZoneBase classe, tant que vous n’avez pas besoin de fournir la prise en charge des modèles de zone pour les développeurs de pages afin d’ajouter EditorPart des contrôles à votre zone de manière déclarative. Dans ce cas, vous devez ajouter tous les EditorPart contrôles à une zone par programmation. Si vous souhaitez fournir la prise en charge des modèles de zone, vous devez hériter de la EditorZone classe .
Constructeurs
| EditorZone() |
Initialise une nouvelle instance de la classe EditorZone. |
Propriétés
| AccessKey |
Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl) |
| Adapter |
Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| ApplyVerb |
Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final d'appliquer des modifications à un contrôle en mode édition. (Hérité de EditorZoneBase) |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control) |
| AssociatedDisplayModes |
Obtient la collection d'objets WebPartDisplayMode qui sont associés à une zone ToolZone particulière. (Hérité de ToolZone) |
| Attributes |
Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl) |
| BackColor |
Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
| BackImageUrl |
Obtient ou définit l'URL vers une image d'arrière-plan pour une zone. (Hérité de WebZone) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| BorderColor |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
| BorderStyle |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
| BorderWidth |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
| CancelVerb |
Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final d'annuler des modifications apportées à un contrôle en mode édition. (Hérité de EditorZoneBase) |
| ChildControlsCreated |
Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle du balisage HTML généré par ASP.NET. (Hérité de Control) |
| ClientIDMode |
Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control) |
| Context |
Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control) |
| Controls |
Obtient un objet ControlCollection qui représente les contrôles enfants de CompositeControl. (Hérité de CompositeControl) |
| ControlStyle |
Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| CssClass |
Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| DataItemContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control) |
| Display |
Obtient une valeur qui indique si un contrôle ToolZone est actuellement affiché. (Hérité de EditorZoneBase) |
| EditorPartChrome |
Obtient une référence à l'instance de la classe EditorPartChrome associée à la zone EditorZoneBase. (Hérité de EditorZoneBase) |
| EditorParts |
Obtient une collection de tous les contrôles EditorPart contenus dans une zone EditorZoneBase. (Hérité de EditorZoneBase) |
| EditUIStyle |
Obtient les attributs de style pour les contrôles modifiables contenus dans un contrôle ToolZone. (Hérité de ToolZone) |
| EmptyZoneText |
Obtient ou définit un message qui s’affiche quand une zone ne contient aucun contrôle. (Hérité de EditorZoneBase) |
| EmptyZoneTextStyle |
Obtient les attributs de style pour le texte d'espace réservé dans une zone vide. (Hérité de WebZone) |
| Enabled |
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl) |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| ErrorStyle |
Obtient les attributs de style pour restituer le message d'erreur qui est affiché si un contrôle WebPart ne peut pas être chargé ou créé. (Hérité de WebZone) |
| ErrorText |
Obtient ou définit le texte d'un message d'erreur de niveau de zone à afficher dans la partie supérieure de l'interface utilisateur de modification. (Hérité de EditorZoneBase) |
| Events |
Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| FooterStyle |
Obtient les attributs de style pour le contenu de la zone de pied de page d'une zone. (Hérité de WebZone) |
| ForeColor |
Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl) |
| HasAttributes |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control) |
| HasFooter |
Obtient une valeur indiquant si une zone a une zone de pied de page. (Hérité de WebZone) |
| HasHeader |
Obtient une valeur indiquant si une zone a une zone d'en-tête. (Hérité de WebZone) |
| HeaderCloseVerb |
Obtient une référence à l'objet WebPartVerb dans l'en-tête d'un contrôle ToolZone qui est utilisé pour fermer le contrôle. (Hérité de ToolZone) |
| HeaderStyle |
Obtient les attributs de style pour le contenu de la zone d'en-tête d'une zone. (Hérité de WebZone) |
| HeaderText |
Obtient ou définit le texte de la zone d’en-tête d’une zone. (Hérité de EditorZoneBase) |
| HeaderVerbStyle |
Obtient les attributs de style pour tous les verbes d'en-tête affichés dans un contrôle ToolZone. (Hérité de ToolZone) |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| ID |
Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
| InstructionText |
Obtient ou définit le texte dans un contrôle ToolZone qui fournit des instructions destinées aux utilisateurs finaux. (Hérité de EditorZoneBase) |
| InstructionTextStyle |
Obtient les attributs de style pour le texte d'instruction qui apparaît en haut d'un contrôle ToolZone. (Hérité de ToolZone) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control) |
| IsEnabled |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control) |
| LabelStyle |
Obtient les attributs de style pour le contenu des étiquettes qui apparaissent avec les contrôles d'édition dans un contrôle ToolZone. Les contrôles ToolZone dérivés, tels que CatalogZone et EditorZone, appliquent les styles aux étiquettes. (Hérité de ToolZone) |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control) |
| OKVerb |
Obtient une référence à un objet WebPartVerb qui applique des modifications à un contrôle en mode édition, et masque l'interface utilisateur de modification. (Hérité de EditorZoneBase) |
| Padding |
Obtient ou définit les attributs de marge intérieure des cellules sur la table qui contient les contrôles WebPart dans une zone. (Hérité de WebZone) |
| Page |
Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control) |
| PartChromePadding |
Obtient ou définit la distance entre le contenu d'un contrôle WebPart et la bordure du contrôle. (Hérité de WebZone) |
| PartChromeStyle |
Obtient des caractéristiques de style qui s'appliquent aux bordures des contrôles WebPart contenus dans une zone. (Hérité de WebZone) |
| PartChromeType |
Obtient ou définit le type de bordure qui encadre les contrôles WebPart contenus dans une zone. (Hérité de WebZone) |
| PartStyle |
Obtient des caractéristiques de style qui s'appliquent à la bordure et au contenu de chaque contrôle WebPart contenu dans une zone. (Hérité de WebZone) |
| PartTitleStyle |
Obtient des attributs de style pour le contenu de la barre de titre de chaque contrôle WebPart contenu dans une zone. (Hérité de WebZone) |
| RenderClientScript |
Obtient une valeur indiquant s'il faut restituer le script client sur une page WebPart. (Hérité de WebZone) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control) |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl) |
| SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l'attribut |
| TabIndex |
Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
| TagKey |
Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebZone) |
| TagName |
Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control) |
| ToolTip |
Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl) |
| UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control) |
| VerbButtonType |
Obtient ou définit le genre de bouton utilisé pour représenter des verbes dans une zone. (Hérité de WebZone) |
| VerbStyle |
Obtient les attributs de style pour les verbes d'interface utilisateur associés aux contrôles WebPart dans une zone. (Hérité de WebZone) |
| ViewState |
Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control) |
| Visible |
Obtient ou définit une valeur indiquant si un contrôle serveur est rendu sous la forme d'un élément d'interface utilisateur sur la page. (Hérité de ToolZone) |
| WebPartManager |
Obtient une référence au contrôle WebPartManager associé à une instance de contrôle WebZone sur une page WebPart. (Hérité de WebZone) |
| WebPartToEdit |
Obtient une référence au contrôle WebPart en cours d'édition. (Hérité de EditorZoneBase) |
| Width |
Obtient ou définit la largeur du contrôle serveur web. (Hérité de WebControl) |
| ZoneTemplate |
Fournit un modèle pour contenir des contrôles enfants dans un contrôle EditorZone dans le format de persistance de la page. |
Méthodes
| AddAttributesToRender(HtmlTextWriter) |
Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| AddedControl(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le traçage au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Affecte à la valeur ClientID mise en cache la valeur |
| ClearChildControlState() |
Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
| Close() |
Appelée lorsqu'un utilisateur clique sur un verbe Close dans l'en-tête d'une zone, cette méthode met fin au processus d'édition des contrôles WebPart et rétablit le mode de navigation d'une page WebPart. (Hérité de EditorZoneBase) |
| CopyBaseAttributes(WebControl) |
Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| CreateChildControls() |
Crée le jeu de contrôles enfants associé à une zone EditorZoneBase. (Hérité de EditorZoneBase) |
| CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| CreateEditorPartChrome() |
Obtient une référence à un nouvel objet EditorPartChrome utilisé pour le rendu des éléments d'interface utilisateur périphériques présents autour d'une zone EditorZoneBase. (Hérité de EditorZoneBase) |
| CreateEditorParts() |
Crée tous les contrôles EditorPart déclarés dans un modèle de zone dans le format de persistance de la page. |
| DataBind() |
Lie une source de données au CompositeControl et à tous ses contrôles enfants. (Hérité de CompositeControl) |
| DataBind(Boolean) |
Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| Dispose() |
Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au traçage au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
| FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
| Focus() |
Affecte le focus d'entrée à un contrôle. (Hérité de Control) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetEffectiveChromeType(Part) |
Retourne la valeur PartChromeType actuelle réelle ou effective d'un contrôle WebPart, étant donné la propriété PartChromeType de la zone et le mode d'affichage actuel de la page WebPart. (Hérité de WebZone) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetRouteUrl(Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
| HasEvents() |
Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control) |
| InvalidateEditorParts() |
Attribue à la collection des contrôles EditorPart associés à une zone EditorZoneBase une valeur |
| IsLiteralContent() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState(). (Hérité de Control) |
| LoadViewState(Object) |
Charge des informations d'état enregistrées précédemment pour une zone. (Hérité de EditorZoneBase) |
| MapPathSecure(String) |
Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page. (Hérité de Control) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Déclenche l'événement DisplayModeChanged et détruit tous les contrôles enfants et EditorPart présents dans la zone en préparation pour une page Web, afin d'entrer en mode d'affichage d'édition ou d'en sortir. (Hérité de EditorZoneBase) |
| OnInit(EventArgs) |
Crée des gestionnaires d'événements spécialisés utilisés par le contrôle WebPartManager sur une page Web. (Hérité de ToolZone) |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l'événement PreRender et appelle la méthode PerformPreRender() pour les éléments de chrome des contrôles EditorPart. (Hérité de EditorZoneBase) |
| OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Déclenche l'événement SelectedWebPartChanged et attribue à la collection EditorParts une valeur |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostBackEvent(String) |
Effectue les actions associées à l'un des verbes de zone ou déclenche un événement qui publie en retour vers le serveur. (Hérité de EditorZoneBase) |
| RecreateChildControls() |
Recrée les contrôles enfants dans un contrôle dérivé de CompositeControl. (Hérité de CompositeControl) |
| RemovedControl(Control) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
| Render(HtmlTextWriter) |
Génère le rendu de la zone via l'objet HtmlTextWriter spécifié. (Hérité de EditorZoneBase) |
| RenderBeginTag(HtmlTextWriter) |
Génère le rendu de la balise d'ouverture HTML du contrôle de zone via l'objet HtmlTextWriter spécifié. (Hérité de WebZone) |
| RenderBody(HtmlTextWriter) |
Substitue la méthode de base pour effectuer le rendu du corps d'une zone dérivé de la classe EditorZoneBase. (Hérité de EditorZoneBase) |
| RenderChildren(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Génère le rendu de tout le contenu d'un contrôle de zone entre les balises de début et de fin à l'objet via HtmlTextWriter spécifié. (Hérité de WebZone) |
| RenderControl(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control) |
| RenderEndTag(HtmlTextWriter) |
Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
| RenderFooter(HtmlTextWriter) |
Substitue la méthode de base pour restituer des verbes dans le pied de page d'un contrôle ToolZone. (Hérité de ToolZone) |
| RenderHeader(HtmlTextWriter) |
Substitue la méthode de base pour fournir le rendu spécialisé pour la zone d'en-tête requis par les contrôles ToolZone. (Hérité de ToolZone) |
| RenderVerb(HtmlTextWriter, WebPartVerb) |
Génère le rendu d'un verbe individuel avec un contrôle ToolZone. (Hérité de ToolZone) |
| RenderVerbs(HtmlTextWriter) |
Génère le rendu des verbes qui s'appliquent au niveau de la zone. (Hérité de EditorZoneBase) |
| ResolveAdapter() |
Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
| SaveControlState() |
Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre les changements d’état d’affichage qui se sont produits après qu’une page a été republiée sur le serveur. (Hérité de EditorZoneBase) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| TrackViewState() |
Effectue le suivi des modifications apportées à l’état d’affichage d’un contrôle de zone. (Hérité de EditorZoneBase) |
Événements
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| Disposed |
Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control) |
| PreRender |
Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control) |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Permet à un concepteur de recréer dans l'environnement au moment du design la collection du contrôle composite de contrôles enfants. (Hérité de CompositeControl) |
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Implémente la méthode RaisePostBackEvent(String). (Hérité de ToolZone) |
Méthodes d’extension
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
| GetDefaultValues(INamingContainer) |
Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. |
| GetMetaTable(INamingContainer) |
Obtient les métadonnées de table pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable) |
Définit les métadonnées de table pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si des métadonnées de table sont disponibles. |
| EnableDynamicData(INamingContainer, Type) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour