WebPartZoneBase 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 classe de base pour tous les contrôles de zone qui agissent en tant que conteneurs pour WebPart (ou d’autres contrôles serveur ou utilisateur).
public ref class WebPartZoneBase abstract : System::Web::UI::WebControls::WebParts::WebZone, System::Web::UI::IPostBackEventHandlerpublic abstract class WebPartZoneBase : System.Web.UI.WebControls.WebParts.WebZone, System.Web.UI.IPostBackEventHandlertype WebPartZoneBase = class
inherit WebZone
interface IPostBackEventHandlerPublic MustInherit Class WebPartZoneBase
Inherits WebZone
Implements IPostBackEventHandler- Héritage
- Dérivé
- Implémente
Exemples
L’exemple de code suivant illustre l’utilisation de la WebPartZoneBase classe. Le code montre comment une classe dérivée, est WebPartZoneutilisée de manière déclarative dans une page de composants WebPart pour contenir des WebPart contrôles. L’exemple de code comporte quatre sections : les trois premières sections décrivent les fichiers de code, et la quatrième explique comment exécuter le code.
La première partie de l’exemple de code est un contrôle utilisateur qui permet aux utilisateurs de basculer la page en différents modes d’affichage. Pour plus d’informations sur les modes d’affichage des composants WebPart et une description du code 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, modeName);
DisplayModeDropdown.Items.Add(item);
}
}
// If shared scope is allowed for this user, display the scope-switching
// UI and select the appropriate radio button for the current user scope.
if (_manager.Personalization.CanEnterSharedScope)
{
Panel2.Visible = true;
if (_manager.Personalization.Scope == PersonalizationScope.User)
RadioButton1.Checked = true;
else
RadioButton2.Checked = true;
}
}
// 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;
}
// Set the selected item equal to the current display mode.
void Page_PreRender(object sender, EventArgs e)
{
ListItemCollection items = DisplayModeDropdown.Items;
int selectedIndex =
items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
DisplayModeDropdown.SelectedIndex = selectedIndex;
}
// Reset all of a user's personalization data for the page.
protected void LinkButton1_Click(object sender, EventArgs e)
{
_manager.Personalization.ResetPersonalizationState();
}
// If not in User personalization scope, toggle into it.
protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.Scope == PersonalizationScope.Shared)
_manager.Personalization.ToggleScope();
}
// If not in Shared scope, and if user is allowed, toggle the scope.
protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope &&
_manager.Personalization.Scope == PersonalizationScope.User)
_manager.Personalization.ToggleScope();
}
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</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, modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
' If shared scope is allowed for this user, display the scope-switching
' UI and select the appropriate radio button for the current user scope.
If _manager.Personalization.CanEnterSharedScope Then
Panel2.Visible = True
If _manager.Personalization.Scope = PersonalizationScope.User Then
RadioButton1.Checked = True
Else
RadioButton2.Checked = True
End If
End If
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
' Set the selected item equal to the current display mode.
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
Dim items As ListItemCollection = DisplayModeDropdown.Items
Dim selectedIndex As Integer = _
items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
DisplayModeDropdown.SelectedIndex = selectedIndex
End Sub
' Reset all of a user's personalization data for the page.
Protected Sub LinkButton1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
_manager.Personalization.ResetPersonalizationState()
End Sub
' If not in User personalization scope, toggle into it.
Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.Scope = PersonalizationScope.Shared Then
_manager.Personalization.ToggleScope()
End If
End Sub
' If not in Shared scope, and if user is allowed, toggle the scope.
Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope AndAlso _
_manager.Personalization.Scope = PersonalizationScope.User Then
_manager.Personalization.ToggleScope()
End If
End Sub
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120" />
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
La deuxième partie de l’exemple de code est un fichier à côté du code qui contient le code permettant de gérer les événements pour la page web principale. Le code de ce fichier montre comment utiliser certains des membres clés WebPartZoneBase par programmation.
using System;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
public partial class WebPartZoneBase_overview : System.Web.UI.Page
{
protected void Page_Load(Object sender, EventArgs e)
{
Label1.Text = DateTime.Now.ToLongDateString();
Label2.Text = String.Empty;
}
protected void Button1_Click(object sender, EventArgs e)
{
if (WebPartZone2.VerbButtonType == ButtonType.Button)
WebPartZone2.VerbButtonType = ButtonType.Link;
else
WebPartZone2.VerbButtonType = ButtonType.Button;
}
protected void Button2_Click(object sender, EventArgs e)
{
if (WebPartZone1.LayoutOrientation == Orientation.Vertical)
WebPartZone1.LayoutOrientation = Orientation.Horizontal;
else
WebPartZone1.LayoutOrientation = Orientation.Vertical;
Page_Load(sender, e);
}
protected void Button3_Click(object sender, EventArgs e)
{
StringBuilder builder = new StringBuilder();
builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br />");
foreach (WebPart part in WebPartZone1.WebParts)
{
builder.AppendLine("ID: " + part.ID
+ "; Type: " + part.GetType()
+ @"<br />");
}
Label2.Text = builder.ToString();
Label2.Visible = true;
}
protected void Button4_Click(object sender, EventArgs e)
{
StringBuilder builder = new StringBuilder();
builder.AppendLine(@"<strong>WebPartZone1 DisplayTitle Property</strong><br />");
builder.AppendLine(WebPartZone1.DisplayTitle + @"<br />");
Label2.Text = builder.ToString();
Label2.Visible = true;
}
}
Imports System.Text
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Partial Public Class WebPartZoneBase_overview
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
Label1.Text = DateTime.Now.ToLongDateString()
Label2.Text = String.Empty
End Sub
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
If WebPartZone2.VerbButtonType = ButtonType.Button Then
WebPartZone2.VerbButtonType = ButtonType.Link
Else
WebPartZone2.VerbButtonType = ButtonType.Button
End If
End Sub
Protected Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
If WebPartZone1.LayoutOrientation = Orientation.Vertical Then
WebPartZone1.LayoutOrientation = Orientation.Horizontal
Else
WebPartZone1.LayoutOrientation = Orientation.Vertical
End If
Page_Load(sender, e)
End Sub
Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim builder As New StringBuilder()
builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br />")
Dim part As WebPart
For Each part In WebPartZone1.WebParts
builder.AppendLine("ID: " + part.ID + "; Type: " _
+ part.GetType().ToString() _
+ "<br />")
Next part
Label2.Text = builder.ToString()
Label2.Visible = True
End Sub
Protected Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim builder As New StringBuilder()
builder.AppendLine("<strong>WebPartZone1 DisplayTitle Property</strong><br />")
builder.AppendLine(WebPartZone1.DisplayTitle + "<br />")
Label2.Text = builder.ToString()
Label2.Visible = True
End Sub
End Class
La troisième partie de l’exemple de code est la page Web qui contient les contrôles qui présentent le WebPartZone comportement de la classe de base WebPartZoneBase et WebPart les contrôles contenus dans les zones.
<%@ Page Language="C#"
Codefile="webpartzonebase_overview.cs"
Inherits="WebPartZoneBase_overview" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<!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>WebPartZoneBase Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" Runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<table width="75%">
<tr>
<td>
<asp:WebPartZone
ID="WebPartZone1"
Runat="server"
LayoutOrientation="Vertical" >
<EditVerb Text="Edit WebPart" />
<SelectedPartChromeStyle BackColor="LightBlue" />
<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>
</td>
<td valign="top" align="right">
<asp:WebPartZone
ID="WebPartZone2"
Runat="server"
DragHighlightColor="#00ff00"
AllowLayoutChange="true"
EmptyZoneText="Add WebParts to this empty Zone."
BorderWidth="2"
BorderColor="DarkBlue"
BorderStyle="Dashed"
MenuLabelText="Verbs Menu"
MenuPopupImageUrl="label.gif" >
<VerbStyle Font-Italic="true" />
<MenuLabelStyle BackColor="Lime" BorderWidth="1" />
<MenuLabelHoverStyle Font-Bold="true" />
<MenuVerbHoverStyle BackColor="LightGrey" />
<MenuVerbStyle Font-Italic="true" />
<ZoneTemplate>
<asp:Label ID="Label1" Runat="server" Title="Date" />
</ZoneTemplate>
</asp:WebPartZone>
</td>
</tr>
<tr>
<td>
<asp:EditorZone ID="EditorZone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
Runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
</td>
</tr>
</table>
</div>
<asp:Button ID="Button1" Runat="server"
Width="200" Text="Toggle WebPartZone2 Buttons"
OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" Runat="server"
Width="200" Text="Toggle Layout Orientation"
OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" Runat="server"
Width="200" Text="List WebPartZone1 WebParts"
OnClick="Button3_Click" />
<br />
<asp:Button ID="Button4" Runat="server"
Width="200" Text="WebPartZone1 Display Title"
OnClick="Button4_Click" />
<br />
<asp:Label ID="Label2" Runat="server" Visible="false" />
</form>
</body>
</html>
<%@ Page Language="VB"
Codefile="webpartzonebase_overview.vb"
Inherits="WebPartZoneBase_overview" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<!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 id="Head1" runat="server">
<title>WebPartZoneBase Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" Runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<table width="75%">
<tr>
<td>
<asp:WebPartZone
ID="WebPartZone1"
Runat="server"
LayoutOrientation="Vertical" >
<EditVerb Text="Edit WebPart" />
<SelectedPartChromeStyle BackColor="LightBlue" />
<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>
</td>
<td valign="top" align="right">
<asp:WebPartZone
ID="WebPartZone2"
Runat="server"
DragHighlightColor="#00ff00"
AllowLayoutChange="true"
EmptyZoneText="Add WebParts to this empty Zone."
BorderWidth="2"
BorderColor="DarkBlue"
BorderStyle="Dashed"
MenuLabelText="Verbs Menu"
MenuPopupImageUrl="label.gif" >
<VerbStyle Font-Italic="true" />
<MenuLabelStyle BackColor="Lime" BorderWidth="1" />
<MenuLabelHoverStyle Font-Bold="true" />
<MenuVerbHoverStyle BackColor="LightGrey" />
<MenuVerbStyle Font-Italic="true" />
<ZoneTemplate>
<asp:Label ID="Label1" Runat="server" Title="Date" />
</ZoneTemplate>
</asp:WebPartZone>
</td>
</tr>
<tr>
<td>
<asp:EditorZone ID="EditorZone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
Runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
</td>
</tr>
</table>
</div>
<asp:Button ID="Button1" Runat="server"
Width="200" Text="Toggle WebPartZone2 Buttons"
OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" Runat="server"
Width="200" Text="Toggle Layout Orientation"
OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" Runat="server"
Width="200" Text="List WebPartZone1 WebParts"
OnClick="Button3_Click" />
<br />
<asp:Button ID="Button4" Runat="server"
Width="200" Text="WebPartZone1 Display Title"
OnClick="Button4_Click" />
<br />
<asp:Label ID="Label2" Runat="server" Visible="false" />
</form>
</body>
</html>
Chargez la page web dans un navigateur. Utilisez le contrôle de liste déroulante Mode d’affichage pour basculer la page en mode création, cliquez sur les WebPart contrôles et essayez de les faire glisser entre les zones visibles. Cliquez sur certains des boutons de la page pour voir l’effet de l’utilisation de différents membres de la WebPartZoneBase classe. Ensuite, basculez la page en mode édition. Vérifiez qu’un WebPart contrôle est positionné dans WebPartZone2, cliquez sur le menu verbes dans la barre de titre du contrôle, puis cliquez sur Modifier pour modifier le contrôle. Terminez la modification de ce contrôle, puis modifiez l’un des contrôles dans l’autre zone. Lorsque vous effectuez ces étapes, notez les différences dans les styles d’interface utilisateur des contrôles et des zones, qui sont l’effet de l’utilisation des différents membres de la WebPartZoneBase classe.
Remarques
Dans le jeu de contrôles Composants WebPart, une zone est un contrôle composite, rendu sous la forme d’une table HTML, qui contient d’autres contrôles dans une région définie d’une page Web. La WebPartZoneBase classe est une zone qui hérite de la classe de base et fournit un ensemble de comportements de base WebZone pour les zones dérivées qui contiennent des WebPart contrôles, des contrôles serveur et des contrôles utilisateur. La combinaison de WebPartZoneBase zones avec WebPart (et d’autres serveurs) forme l’interface utilisateur principale d’une application De composants WebPart, la vue normale d’une page que les utilisateurs interagissent avec la plupart du temps.
Toutes les zones fournissent un ensemble commun d’éléments d’interface utilisateur pour les contrôles qu’elles contiennent. Pour une discussion détaillée des éléments d’interface utilisateur communs à toutes les zones, consultez la rubrique vue d’ensemble de la classe pour la WebZone classe. La WebPartZoneBase zone inclut une section de corps qui contient des contrôles serveur et un objet associé WebPartChrome utilisé pour le rendu des contrôles contenus et de leurs éléments chromes, tels que leurs verbes, leurs bordures, etc.
En plus des fonctionnalités héritées de la classe, la WebPartZoneBase classe ajoute le glissement de contrôle côté client, des verbes spécifiques (pour activer les actions courantes de l’interface utilisateur telles que la réduction, la fermeture, la WebZone suppression et les contrôles d’édition) et des fonctionnalités de style supplémentaires. La WebPartZoneBase classe est également la classe à hériter si vous souhaitez concevoir une zone personnalisée pilotée par la base de données. Par exemple, vous pouvez créer une zone de composants WebPart météo personnalisée qui hérite et WebPartZoneBaseest conçue pour contenir et fournir des fonctionnalités de disposition et d’autres services pour WebPart les contrôles liés aux données et afficher les informations météorologiques.
La WebPartZoneBase classe contient un certain nombre de propriétés permettant d’utiliser des attributs de style dans une zone. Il existe plusieurs propriétés pour les bordures, notamment BorderStyle et BorderWidth. Il existe un groupe de propriétés permettant d’utiliser des attributs de style de menus qui peuvent apparaître dans l’en-tête d’une zone, par MenuLabelStyleexemple, MenuVerbStyleet d’autres.
La WebPartZoneBase classe contient également un certain nombre de membres pour la gestion des verbes dans une zone. Ces membres sont liés aux verbes qui apparaissent sur les contrôles de partie dans la zone. Bien que les verbes au niveau de la zone puissent être ajoutés à WebPartZoneBase des zones, par défaut, ils n’ont pas de verbes au niveau de la zone. Il existe un ensemble de verbes standard fournis avec le jeu de contrôles Composants WebPart à utiliser avec des contrôles de composants, et les développeurs peuvent également ajouter des verbes personnalisés. Certaines propriétés importantes pour l’utilisation de verbes incluent des propriétés qui référencent certains des objets verbes standard, tels que CloseVerb, DeleteVerbConnectVerbet EditVerb, HelpVerbet , et MinimizeVerb. Les verbes standard apparaissent dans un menu détaillé (généralement présentés dans l’interface utilisateur sous la forme d’un menu déroulant) dans la barre de titre de chaque contrôle contenu dans une zone. Il existe également une VerbButtonType propriété qui vous permet de déterminer le type d’objet cliquable qui représente un verbe dans l’interface utilisateur.
D’autres membres clés pour travailler avec des verbes incluent la OnCreateVerbs méthode, qui est un gestionnaire d’événements qui peut être substitué pour la gestion personnalisée du processus de création de verbes et l’événement CreateVerbs .
La WebPartZoneBase classe contient un certain nombre de membres pour travailler avec WebPart des contrôles contenus dans une zone. La WebParts propriété fait référence à la collection de tous les WebPart contrôles (et autres serveurs) dans la zone. Plusieurs méthodes correspondent aux verbes ou actions standard qu’un utilisateur peut effectuer sur WebPart des contrôles dans une zone, comme CloseWebPart, ConnectWebPartet EditWebPart.
Il existe également un certain nombre de membres dans la WebPartZoneBase classe qui concernent la façon dont les WebPart contrôles sont disposés ou organisés dans la zone. La AllowLayoutChange propriété détermine si les contrôles peuvent être déplacés entre des zones ou réorganisés dans une zone par les utilisateurs. La LayoutOrientation propriété vous permet de déterminer si les contrôles d’une zone sont organisés horizontalement ou verticalement.
Note
Internet Explorer peut afficher la hauteur d’un WebPartZone ou de ses contrôles contenus de manière inattendue, en fonction de l’orientation de la zone. Pour plus d’informations, consultez la documentation relative aux LayoutOrientation propriétés ou aux Height propriétés.
D’autres méthodes de la WebPartZoneBase classe vous fournissent un contrôle programmatique détaillé sur le rendu des différentes zones d’une zone. La plupart de ces méthodes remplacent les méthodes de base héritées de la WebZone classe, pour personnaliser le rendu pour les zones qui contiennent des WebPart contrôles. Les méthodes importantes incluent Render, , RenderBodyRenderDropCueet RenderHeader.
Constructeurs
| Nom | Description |
|---|---|
| WebPartZoneBase() |
Initialise la classe à utiliser par une instance de classe héritée. Ce constructeur ne peut être appelé que par une classe héritée. |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl) |
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AllowLayoutChange |
Obtient ou définit une valeur qui indique si la disposition des WebPart contrôles peut être modifiée dans une zone. |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| Attributes |
Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux 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 sur 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 la bordure d’un WebPartZoneBase contrôle. |
| BorderStyle |
Obtient ou définit le type de bordure qui entoure un WebPartZoneBase contrôle. |
| BorderWidth |
Obtient ou définit la largeur de la bordure qui entoure un WebPartZoneBase contrôle. |
| ChildControlsCreated |
Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le 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 ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control) |
| CloseVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de fermer les WebPart contrôles d’une zone. |
| ConnectVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de créer des connexions entre WebPart les contrôles. |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient un ControlCollection objet qui représente les contrôles enfants dans un CompositeControl. (Hérité de CompositeControl) |
| ControlStyle |
Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| CssClass |
Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DeleteVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de supprimer les WebPart contrôles d’une zone. |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| DisplayTitle |
Obtient la valeur actuelle du texte utilisé comme titre d’une WebPartZoneBase zone lorsque la zone elle-même est visible. |
| DragDropEnabled |
Obtient une valeur qui indique si WebPart les contrôles peuvent être déplacés vers ou hors d’une zone. |
| DragHighlightColor |
Obtient ou définit la couleur autour de la bordure d’une WebPartZoneBase zone et de ses régions drop-cue lorsqu’un utilisateur fait glisser un contrôle. |
| EditVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de modifier WebPart des contrôles dans une zone. |
| EmptyZoneText |
Obtient ou définit un message qui s’affiche lorsqu’un WebPartZoneBase contrôle ne contient aucun WebPart contrôle. |
| EmptyZoneTextStyle |
Obtient les attributs de style pour le texte de l’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 des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| ErrorStyle |
Obtient les attributs de style pour le rendu du message d’erreur qui s’affiche si un WebPart contrôle ne peut pas être chargé ou créé. (Hérité de WebZone) |
| Events |
Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| ExportVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux d’exporter un fichier de définition XML pour chaque WebPart contrôle d’une zone. |
| 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 actuel ont 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. |
| HasHeader |
Obtient une valeur indiquant si une zone a une zone d’en-tête. |
| 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 WebZone) |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| HelpVerb |
Obtient une référence à un WebPartVerb objet utilisé pour accéder au contenu d’aide pour WebPart les contrôles d’une zone. |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de 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) |
| LayoutOrientation |
Obtient ou définit une valeur qui indique si les contrôles d’une zone sont organisés verticalement ou horizontalement. |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control) |
| MenuCheckImageStyle |
Obtient les attributs de style appliqués à l’image de coche qui s’affiche dans un menu verbes en regard du texte de verbe sélectionné. |
| MenuCheckImageUrl |
Obtient ou définit l’URL d’une image utilisée comme coche dans le menu verbes de chaque WebPart contrôle d’une zone. |
| MenuLabelHoverStyle |
Obtient les attributs de style appliqués à l’étiquette d’un menu verbes dans la barre de titre d’un WebPart contrôle lorsqu’un utilisateur positionne le pointeur de la souris sur l’étiquette. |
| MenuLabelStyle |
Obtient des informations de style pour l’étiquette du menu déroulant verbes qui apparaît dans la barre de titre de chaque WebPart contrôle d’une zone. |
| MenuLabelText |
Obtient ou définit la valeur qui sert d’étiquette pour le menu déroulant verbes dans la barre de titre de chaque WebPart contrôle d’une zone. |
| MenuPopupImageUrl |
Obtient ou définit l’URL d’une image qui ouvre le menu déroulant verbes dans la barre de titre de chaque WebPart contrôle d’une zone. |
| MenuPopupStyle |
Obtient des attributs de style pour le menu déroulant des verbes qui s’affichent sur WebPart les contrôles d’une zone. |
| MenuVerbHoverStyle |
Obtient des informations de style pour l’apparence d’un verbe dans un menu déroulant verbes lorsqu’un utilisateur final positionne le pointeur de la souris sur le verbe. |
| MenuVerbStyle |
Obtient des informations de style pour l’apparence d’un verbe dans un menu déroulant verbes lorsque le menu est affiché. |
| MinimizeVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de réduire les WebPart contrôles d’une zone. |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control) |
| Padding |
Obtient ou définit les attributs de remplissage de cellule sur le tableau qui contient les WebPart contrôles d’une zone. (Hérité de WebZone) |
| Page |
Obtient une référence à l’instance 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 page. (Hérité de Control) |
| PartChromePadding |
Obtient ou définit la distance entre le contenu d’un WebPart contrôle et la bordure du contrôle. (Hérité de WebZone) |
| PartChromeStyle |
Obtient les caractéristiques de style qui s’appliquent aux bordures des contrôles De composants WebPart contenus dans une zone. (Hérité de WebZone) |
| PartChromeType |
Obtient ou définit le type de bordure qui trame les contrôles de composants WebPart contenus dans une zone. (Hérité de WebZone) |
| PartStyle |
Obtient les caractéristiques de style qui s’appliquent à la bordure et au contenu de chaque contrôle WebPart contenu par une zone. (Hérité de WebZone) |
| PartTitleStyle |
Obtient les attributs de style pour le contenu de la barre de titre pour chaque contrôle WebPart contenu dans une zone. (Hérité de WebZone) |
| RenderClientScript |
Obtient une valeur qui indique s’il faut afficher le script client sur une page de composants WebPart. (Hérité de WebZone) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RestoreVerb |
Obtient une référence à un WebPartVerb objet qui permet aux utilisateurs finaux de restaurer WebPart des contrôles dans une zone à la taille normale. |
| SelectedPartChromeStyle |
Obtient des informations de style pour l’apparence d’un contrôle sélectionné WebPart dans une zone. |
| ShowTitleIcons |
Obtient ou définit une valeur qui indique si les icônes de titre sont affichées dans la barre de titre de chaque WebPart contrôle d’une zone. |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du 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 HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebZone) |
| TagName |
Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les 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 PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| TitleBarVerbButtonType |
Obtient ou définit le type de bouton utilisé pour les verbes dans la barre de titre des WebPart contrôles. |
| TitleBarVerbStyle |
Obtient des attributs de style pour les verbes dans la barre de titre d’un WebPart contrôle. |
| ToolTip |
Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le 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 du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control) |
| VerbButtonType |
Obtient ou définit le type de bouton associé aux verbes qui existent dans une WebPartZoneBase zone lorsqu’il est accessible avec un navigateur plus ancien. |
| 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 sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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 qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control) |
| WebPartChrome |
Obtient une référence à l’objet WebPartChrome qui détermine le rendu périphérique des WebPart contrôles dans la zone. |
| WebPartManager |
Obtient une référence au WebPartManager contrôle associé à une WebZone instance de contrôle sur une page de composants WebPart. (Hérité de WebZone) |
| WebParts |
Obtient la collection de contrôles WebPart contenus dans une zone. |
| WebPartVerbRenderMode |
Obtient ou définit une valeur indiquant comment les verbes doivent être rendus sur WebPart les contrôles de la zone. |
| Width |
Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl) |
Méthodes
| Nom | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Ajoute des attributs et des styles HTML qui doivent être rendus dans le fichier spécifié HtmlTextWriterTag. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection 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 du ControlCollection contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les 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 page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour 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() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| CloseWebPart(WebPart) |
Ferme un contrôle sélectionné WebPart dans une zone. |
| ConnectWebPart(WebPart) |
Lance le processus de création d’une connexion entre deux WebPart contrôles. |
| 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 les développeurs de contrôles. (Hérité de WebControl) |
| CreateChildControls() |
Crée l’ensemble de contrôles enfants contenus dans une zone. |
| CreateControlCollection() |
Crée un ControlCollection objet qui contient tous les contrôles d’une zone. |
| CreateControlStyle() |
Crée un ensemble de caractéristiques de style qui s’appliquent à un contrôle de zone lorsqu’il est visible. |
| CreateWebPartChrome() |
Permet aux zones dérivées de remplacer un objet personnalisé WebPartChrome pour modifier l’apparence des WebPart contrôles dans une zone. |
| DataBind() |
Lie une source de données aux contrôles enfants et à CompositeControl 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) |
| DeleteWebPart(WebPart) |
Supprime un contrôle sélectionné WebPart dans une zone. |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EditWebPart(WebPart) |
Lance le processus de modification d’un contrôle sélectionné WebPart dans une zone. |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur 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 actuelle réelle PartChromeType ou effective d’un WebPart contrôle, en fonction de la PartChromeType propriété de la zone et du mode d’affichage actuel de la page Composants WebPart. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetInitialWebParts() |
Obtient une collection initiale de WebPart contrôles contenus dans une zone, en fonction d’un modèle ou d’un support de stockage. |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la UniqueID propriété 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 les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control) |
| LoadViewState(Object) |
Charge les informations d’état précédemment enregistrées pour une zone. |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| MinimizeWebPart(WebPart) |
Réduit un contrôle sélectionné WebPart dans une zone. |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control) |
| OnCreateVerbs(WebPartVerbsEventArgs) |
Déclenche l’événement CreateVerbs. |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnInit(EventArgs) |
Déclenche l’événement Init. (Hérité de WebZone) |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l’événement PreRender. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostBackEvent(String) |
Met à jour l’état de la collection actuelle de WebPart contrôles dans une zone, en fonction des modifications qui se sont produites depuis l’événement de publication le plus récent. |
| RecreateChildControls() |
Recrée les contrôles enfants dans un contrôle dérivé de CompositeControl. (Hérité de CompositeControl) |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Restitue la zone à l’objet spécifié HtmlTextWriter . |
| RenderBeginTag(HtmlTextWriter) |
Affiche la balise HTML ouvrante du contrôle de zone sur l’objet spécifié HtmlTextWriter . (Hérité de WebZone) |
| RenderBody(HtmlTextWriter) |
Remplace la méthode de base pour afficher la zone de corps d’une zone dérivée de la WebPartZoneBase classe. |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Affiche l’intégralité du contenu d’un contrôle de zone entre les balises de début et de fin sur l’objet spécifié HtmlTextWriter . (Hérité de WebZone) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control) |
| RenderDropCue(HtmlTextWriter) |
Restitue les éléments d’interface utilisateur pour indiquer à un utilisateur final où un WebPart contrôle qui est déplacé peut être supprimé dans une zone. |
| RenderEndTag(HtmlTextWriter) |
Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderFooter(HtmlTextWriter) |
Remplace le rendu du pied de page d’un contrôle de zone. (Hérité de WebZone) |
| RenderHeader(HtmlTextWriter) |
Remplace la méthode de base pour afficher l’en-tête d’une WebPartZoneBase zone qui contient des WebPart contrôles. |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur. (Hérité de Control) |
| RestoreWebPart(WebPart) |
Restaure un contrôle sélectionné WebPart qui a été réduit à l’état normal. |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre les modifications de l’état d’affichage qui se sont produites après la publication d’une page sur le serveur. |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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() |
Commence le processus de suivi des modifications de l’état d’affichage dans une zone afin qu’elles puissent être stockées dans un StateBag objet et accessibles via la ViewState propriété. |
Événements
| Nom | Description |
|---|---|
| CreateVerbs |
Se produit lorsque les verbes sont créés pour une zone qui dérive de la WebPartZoneBase classe. |
| 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, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est 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
| Nom | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Permet à un concepteur de recréer la collection de contrôles enfants du contrôle composite dans l’environnement au moment du design. (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) |
Pour obtenir une description de ce membre, consultez RaisePostBackEvent(String). |
Méthodes d’extension
| Nom | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| 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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
| 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, IDictionary<String,Object>) |
Définit les métadonnées de table et le mappage de 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 de valeurs par défaut 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é. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si les métadonnées de table sont disponibles. |
