Menu 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.
Affiche un menu dans une page web ASP.NET.
public ref class Menu : System::Web::UI::WebControls::HierarchicalDataBoundControl, System::Web::UI::INamingContainer, System::Web::UI::IPostBackEventHandler[System.Web.UI.ControlValueProperty("SelectedValue")]
public class Menu : System.Web.UI.WebControls.HierarchicalDataBoundControl, System.Web.UI.INamingContainer, System.Web.UI.IPostBackEventHandler[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type Menu = class
inherit HierarchicalDataBoundControl
interface IPostBackEventHandler
interface INamingContainerPublic Class Menu
Inherits HierarchicalDataBoundControl
Implements INamingContainer, IPostBackEventHandler- Héritage
- Attributs
- Implémente
Exemples
L’exemple de code suivant montre comment créer un Menu contrôle avec des éléments de menu statiques à l’aide de la syntaxe déclarative.
<%@ Page Language="C#" %>
<!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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu Declarative Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Declarative Example</h3>
<!-- Use declarative syntax to create the -->
<!-- menu structure. Submenu items are -->
<!-- created by nesting them in parent menu -->
<!-- items. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Home"
tooltip="Home">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Movies"
tooltip="Movies">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu Declarative Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Declarative Example</h3>
<!-- Use declarative syntax to create the -->
<!-- menu structure. Submenu items are -->
<!-- created by nesting them in parent menu -->
<!-- items. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Home"
tooltip="Home">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Movies"
tooltip="Movies">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
L’exemple de code suivant montre comment lier le Menu contrôle à un SiteMapDataSource contrôle. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données de carte de site ci-dessous dans un fichier nommé Web.plan.
<%@ Page Language="C#" %>
<!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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu DataBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu DataBinding Example</h3>
<!-- Bind the Menu control to a SiteMapDataSource control. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
datasourceid="MenuSource"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu DataBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu DataBinding Example</h3>
<!-- Bind the Menu control to a SiteMapDataSource control. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
datasourceid="MenuSource"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
runat="server"/>
</form>
</body>
</html>
Voici un exemple de données de carte de site pour l’exemple précédent.
<siteMap>
<siteMapNode url="~\Home.aspx"
title="Home"
description="Home">
<siteMapNode url="~\Music.aspx"
title="Music"
description="Music">
<siteMapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<siteMapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<siteMapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</siteMapNode>
<siteMapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<siteMapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<siteMapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<siteMapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</siteMapNode>
</siteMapNode>
</siteMap>
Remarques
Dans cette rubrique :
Présentation
Le Menu contrôle est utilisé pour afficher un menu dans une page web ASP.NET et est souvent utilisé en combinaison avec un SiteMapDataSource contrôle permettant de naviguer sur un site Web. Le Menu contrôle prend en charge les fonctionnalités suivantes :
Liaison de données qui permet aux éléments de menu du contrôle d’être liés à des sources de données hiérarchiques.
Navigation de site via l’intégration au SiteMapDataSource contrôle.
Accès programmatique au Menu modèle objet pour créer dynamiquement des menus, remplir des éléments de menu, définir des propriétés, et ainsi de suite.
Apparence personnalisable via des thèmes, des images définies par l’utilisateur, des styles et des modèles définis par l’utilisateur.
Lorsque l’utilisateur clique sur un élément de menu, le Menu contrôle peut accéder à une page Web liée ou simplement publier sur le serveur. Si la NavigateUrl propriété d’un élément de menu est définie, le Menu contrôle accède à la page liée ; sinon, il publie la page sur le serveur pour traitement. Par défaut, une page liée s’affiche dans la même fenêtre ou cadre que le Menu contrôle. Pour afficher le contenu lié dans une autre fenêtre ou cadre, utilisez la Target propriété du Menu contrôle.
Note
La Target propriété affecte chaque élément de menu du contrôle. Pour spécifier une fenêtre ou un cadre pour un élément de menu individuel, définissez la Target propriété de l’objet MenuItem directement.
Le Menu contrôle affiche deux types de menus : un menu statique et un menu dynamique. Le menu statique est toujours affiché dans un Menu contrôle. Par défaut, les éléments de menu au niveau racine (niveau 0) sont affichés dans le menu statique. Vous pouvez afficher des niveaux de menu supplémentaires (sous-menu statique) dans le menu statique en définissant la StaticDisplayLevels propriété. Les éléments de menu (le cas échéant) avec un niveau supérieur à la valeur spécifiée par la StaticDisplayLevels propriété sont affichés dans un menu dynamique. Un menu dynamique apparaît uniquement lorsque l’utilisateur positionne le pointeur de la souris sur l’élément de menu parent qui contient un sous-menu dynamique. Les menus dynamiques disparaissent automatiquement après une certaine durée. Utilisez la DisappearAfter propriété pour spécifier la durée.
Note
Un menu dynamique disparaît également lorsque l’utilisateur clique en dehors du menu.
Vous pouvez également limiter le nombre de niveaux affichés dans un menu dynamique en définissant la MaximumDynamicDisplayLevels propriété. Les niveaux de menu supérieurs à la valeur spécifiée sont ignorés.
Note
Le Menu contrôle n’est pas conçu pour être utilisé à l’intérieur d’un UpdatePanel contrôle. Vous ne pouvez ajouter le Menu contrôle qu’à une page en dehors d’un UpdatePanel contrôle. UpdatePanel les contrôles sont utilisés pour mettre à jour les régions sélectionnées d’une page au lieu de mettre à jour toute la page avec une publication. Pour plus d’informations, consultez UpdatePanel Control Overview et Partial-Page Rendering Overview.
Éléments de menu
Un Menu contrôle est constitué d’une arborescence d’éléments de menu représentés par MenuItem des objets. Les éléments de menu au niveau supérieur (niveau 0) sont appelés éléments de menu racine. Un élément de menu qui a un élément de menu parent est appelé élément de menu enfant. Tous les éléments de menu racine sont stockés dans la Items collection. Les éléments de menu enfants sont stockés dans la collection de l’élément de ChildItems menu parent.
Chaque élément de menu a une propriété et une TextValue propriété. La valeur de la Text propriété est affichée dans le Menu contrôle, tandis que la Value propriété est utilisée pour stocker des données supplémentaires sur l’élément de menu, telles que les données transmises à l’événement de publication associé à l’élément de menu. Lorsque vous cliquez sur un clic, un élément de menu peut accéder à une autre page Web indiquée par la NavigateUrl propriété.
Note
Si la NavigateUrl propriété n’est pas définie pour un élément de menu, le Menu contrôle envoie simplement la page au serveur pour traitement lorsque l’élément de menu est cliqué.
Vous pouvez également afficher une image dans un élément de menu en définissant la ImageUrl propriété.
Pour plus d’informations sur les éléments de menu, consultez MenuItem.
Données statiques
Le modèle de données le Menu plus simple du contrôle est des éléments de menu statiques. Pour afficher des éléments de menu statiques à l’aide de la syntaxe déclarative, commencez par imbriquer les balises d’ouverture et de fermeture <Items> entre les balises d’ouverture et de fermeture du Menu contrôle. Ensuite, créez la structure de menu en imbrication d’éléments <asp:MenuItem> entre les balises d’ouverture et de fermeture <Items> . Chaque <asp:MenuItem> élément représente un élément de menu dans le contrôle et mappe à un MenuItem objet. Vous pouvez définir les propriétés de chaque élément de menu en définissant les attributs de son <asp:MenuItem> élément. Pour créer des éléments de sous-menu, imbriquez des éléments supplémentaires <asp:MenuItem> entre les balises d’ouverture et de fermeture <asp:MenuItem> de l’élément de menu parent.
Liaison à des données
Le Menu contrôle peut utiliser n’importe quel contrôle de source de données hiérarchique, tel qu’un XmlDataSource contrôle ou un SiteMapDataSource contrôle. Pour établir une liaison à un contrôle de source de données hiérarchique, définissez la DataSourceID propriété du Menu contrôle sur la ID valeur du contrôle de source de données. Le Menu contrôle est automatiquement lié au contrôle de source de données spécifié. Il s’agit de la méthode préférée à lier aux données.
Lors de la liaison à une source de données où chaque élément de données contient plusieurs propriétés (comme un élément XML avec plusieurs attributs), un élément de menu affiche la valeur retournée par la ToString méthode de l’élément de données par défaut. Dans le cas d’un élément XML, l’élément de menu affiche le nom de l’élément, qui affiche la structure sous-jacente de l’arborescence de menus, mais n’est pas très utile dans le cas contraire. Vous pouvez lier un élément de menu à une propriété d’élément de données spécifique à l’aide de la DataBindings collection pour spécifier des liaisons d’éléments de menu. La DataBindings collection contient des MenuItemBinding objets qui définissent la relation entre un élément de données et l’élément de menu auquel il est associé. Vous pouvez spécifier les critères de liaison et de propriété d’élément de données à afficher dans le nœud. Pour plus d’informations sur les liaisons d’éléments de menu, consultez MenuItemBinding.
Vous ne pouvez pas créer de nœuds vides dans un Menu contrôle en définissant la ou TextField les Text propriétés sur la chaîne vide ( » « ). La définition de ces propriétés sur la chaîne vide a le même effet que la définition des propriétés. Dans ce cas, le Menu contrôle crée une liaison par défaut à l’aide de la DataSource propriété. Pour plus d’informations, consultez Liaison aux bases de données.
Personnalisation de l’interface utilisateur
Il existe de nombreuses façons de personnaliser l’apparence du Menu contrôle. Tout d’abord, vous pouvez spécifier si le Menu contrôle est rendu horizontalement ou verticalement en définissant la Orientation propriété. Vous pouvez également spécifier un style différent (par exemple, taille de police et couleur) pour chacun des types d’éléments de menu.
Si vous utilisez des feuilles de style en cascade (CSS) pour personnaliser l’apparence du contrôle, utilisez des styles inline ou un fichier CSS distinct, mais pas les deux. L’utilisation des styles inline et d’un fichier CSS distinct peut entraîner des résultats inattendus. Pour plus d’informations sur l’utilisation de feuilles de style avec des contrôles, consultez Contrôles de serveur web et styles CSS.
Le tableau suivant répertorie les styles d’élément de menu disponibles.
| Propriété de style d’élément de menu | Description |
|---|---|
| DynamicHoverStyle | Paramètres de style d’un élément de menu dynamique lorsque le pointeur de la souris est positionné sur celui-ci. |
| DynamicMenuItemStyle | Paramètres de style d’un élément de menu dynamique individuel. |
| DynamicMenuStyle | Paramètres de style d’un menu dynamique. |
| DynamicSelectedStyle | Paramètres de style de l’élément de menu dynamique actuellement sélectionné. |
| StaticHoverStyle | Paramètres de style d’un élément de menu statique lorsque le pointeur de la souris est positionné sur celui-ci. |
| StaticMenuItemStyle | Paramètres de style d’un élément de menu statique individuel. |
| StaticMenuStyle | Paramètres de style d’un menu statique. |
| StaticSelectedStyle | Paramètres de style de l’élément de menu statique actuellement sélectionné. |
Au lieu de définir les propriétés de style individuelles, vous pouvez spécifier des styles appliqués aux éléments de menu en fonction de leur niveau à l’aide des collections de styles suivantes.
| Collections de styles de niveau | Description |
|---|---|
| LevelMenuItemStyles | Collection d’objets MenuItemStyle qui contrôlent le style des éléments de menu sur une base de niveau. |
| LevelSelectedStyles | Collection d’objets MenuItemStyle qui contrôlent le style des éléments de menu sélectionnés sur une base de niveau. |
| LevelSubMenuStyles | Collection d’objets MenuItemStyle qui contrôlent le style des éléments de sous-menu sur une base de niveau. |
Le premier style de la collection correspond au style des éléments de menu au premier niveau de profondeur dans l’arborescence de menus. Le deuxième style de la collection correspond au style des éléments de menu au deuxième niveau de profondeur dans l’arborescence de menus, et ainsi de suite. Cela est le plus souvent utilisé pour générer des menus de navigation de style table des matières où les éléments de menu à une certaine profondeur doivent avoir la même apparence, qu’ils aient ou non des sous-menus.
Note
Si vous utilisez l’une des collections de styles de niveau répertoriées dans le tableau précédent pour définir le style du Menu contrôle, ces paramètres de style remplacent les propriétés de style d’élément de menu individuelles.
Une autre façon de modifier l’apparence du contrôle consiste à personnaliser les images affichées dans le Menu contrôle. Vous pouvez spécifier votre propre image personnalisée pour les différentes parties du contrôle en définissant les propriétés indiquées dans le tableau suivant.
| Propriété Image | Description |
|---|---|
| DynamicBottomSeparatorImageUrl | Image facultative affichée en bas d’un élément de menu dynamique pour la séparer d’autres éléments de menu. |
| DynamicPopOutImageUrl | Image facultative affichée dans un élément de menu dynamique pour indiquer qu’elle a un sous-menu. |
| DynamicTopSeparatorImageUrl | Image facultative affichée en haut d’un élément de menu dynamique pour la séparer des autres éléments de menu. |
| ScrollDownImageUrl | Image affichée en bas d’un élément de menu pour indiquer que l’utilisateur peut faire défiler vers le bas pour afficher des éléments de menu supplémentaires. |
| ScrollUpImageUrl | Image affichée en haut d’un élément de menu pour indiquer que l’utilisateur peut faire défiler jusqu’à afficher des éléments de menu supplémentaires. |
| StaticBottomSeparatorImageUrl | Image facultative affichée en bas d’un élément de menu statique pour la séparer d’autres éléments de menu. |
| StaticPopOutImageUrl | Image facultative affichée dans un élément de menu statique pour indiquer qu’elle a un sous-menu. |
| StaticTopSeparatorImageUrl | Image facultative affichée en haut d’un élément de menu statique pour la séparer des autres éléments de menu. |
Pour contrôler complètement l’interface utilisateur, vous pouvez définir vos propres modèles personnalisés pour le Menu contrôle à l’aide des propriétés de modèle suivantes.
| Propriété template | Description |
|---|---|
| DynamicItemTemplate | Modèle qui contient le contenu personnalisé à afficher pour un élément de menu dynamique. |
| StaticItemTemplate | Modèle qui contient le contenu personnalisé à afficher pour un élément de menu statique. |
Vous pouvez contrôler la position verticale et horizontale d’un menu dynamique par rapport à son élément de menu parent en définissant respectivement les propriétés et DynamicHorizontalOffset les DynamicVerticalOffset propriétés. Pour contrôler la mise en retrait des éléments de sous-menu statiques dans un menu statique, utilisez la StaticSubMenuIndent propriété.
Événements
Le Menu contrôle fournit plusieurs événements que vous pouvez programmer. Cela vous permet d’exécuter une routine personnalisée chaque fois qu’un événement se produit. Le tableau suivant répertorie les événements pris en charge.
| Événement | Description |
|---|---|
| MenuItemClick | Se produit lorsqu’un élément de menu est cliqué. Cet événement est couramment utilisé pour synchroniser un Menu contrôle avec un autre contrôle sur la page. |
| MenuItemDataBound | Se produit lorsqu’un élément de menu est lié aux données. Cet événement est couramment utilisé pour modifier un élément de menu avant qu’il ne soit rendu dans un Menu contrôle. |
Accessibilité
Pour plus d’informations sur la configuration de ce contrôle afin qu’il génère des marques conformes aux normes d’accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et ASP.NET Contrôles et accessibilité.
Syntaxe déclarative
<asp:Menu
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
DataSource="string"
DataSourceID="string"
DisappearAfter="integer"
DynamicBottomSeparatorImageUrl="uri"
DynamicEnableDefaultPopOutImage="True|False"
DynamicHorizontalOffset="integer"
DynamicItemFormatString="string"
DynamicPopOutImageTextFormatString="string"
DynamicPopOutImageUrl="uri"
DynamicTopSeparatorImageUrl="uri"
DynamicVerticalOffset="integer"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ItemWrap="True|False"
MaximumDynamicDisplayLevels="integer"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnMenuItemClick="MenuItemClick event handler"
OnMenuItemDataBound="MenuItemDataBound event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
Orientation="Horizontal|Vertical"
PathSeparator="string"
runat="server"
ScrollDownImageUrl="uri"
ScrollDownText="string"
ScrollUpImageUrl="uri"
ScrollUpText="string"
SkinID="string"
SkipLinkText="string"
StaticBottomSeparatorImageUrl="uri"
StaticDisplayLevels="integer"
StaticEnableDefaultPopOutImage="True|False"
StaticItemFormatString="string"
StaticPopOutImageTextFormatString="string"
StaticPopOutImageUrl="uri"
StaticSubMenuIndent="size"
StaticTopSeparatorImageUrl="uri"
Style="string"
TabIndex="integer"
Target="string"
ToolTip="string"
Visible="True|False"
Width="size"
>
<DataBindings>
<asp:MenuItemBinding
DataMember="string"
Depth="integer"
Enabled="True|False"
EnabledField="string"
FormatString="string"
ImageUrl="uri"
ImageUrlField="string"
NavigateUrl="uri"
NavigateUrlField="string"
PopOutImageUrl="uri"
PopOutImageUrlField="string"
Selectable="True|False"
SelectableField="string"
SeparatorImageUrl="uri"
SeparatorImageUrlField="string"
Target="string"
TargetField="string"
Text="string"
TextField="string"
ToolTip="string"
ToolTipField="string"
Value="string"
ValueField="string"
/>
</DataBindings>
<DynamicHoverStyle />
<DynamicItemTemplate>
<!-- child controls -->
</DynamicItemTemplate>
<DynamicMenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<DynamicMenuStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<DynamicSelectedStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<Items />
<LevelMenuItemStyles>
<asp:MenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|
Double|Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</LevelMenuItemStyles>
<LevelSelectedStyles>
<asp:MenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|
Double|Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</LevelSelectedStyles>
<LevelSubMenuStyles>
<asp:SubMenuStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|
Double|Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</LevelSubMenuStyles>
<StaticHoverStyle />
<StaticItemTemplate>
<!-- child controls -->
</StaticItemTemplate>
<StaticMenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<StaticMenuStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<StaticSelectedStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</asp:Menu>
Constructeurs
| Nom | Description |
|---|---|
| Menu() |
Initialise une nouvelle instance de la classe Menu. |
Champs
| Nom | Description |
|---|---|
| MenuItemClickCommandName |
Contient le nom de la commande. |
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) |
| 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) |
| 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) |
| 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) |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient un ControlCollection qui contient les contrôles enfants du Menu contrôle. |
| 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) |
| DataBindings |
Obtient une collection d’objets qui définissent la relation entre un élément de MenuItemBinding données et l’élément de menu auquel il est associé. |
| 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) |
| DataSource |
Obtient ou définit l’objet à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données. (Hérité de BaseDataBoundControl) |
| DataSourceID |
Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données. (Hérité de HierarchicalDataBoundControl) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| DisappearAfter |
Obtient ou définit la durée pendant laquelle un menu dynamique s’affiche une fois que le pointeur de la souris n’est plus positionné sur le menu. |
| DynamicBottomSeparatorImageUrl |
Obtient ou définit l’URL d’une image à afficher en bas de chaque élément de menu dynamique pour le séparer des autres éléments de menu. |
| DynamicEnableDefaultPopOutImage |
Obtient ou définit une valeur indiquant si l’image intégrée qui indique qu’un élément de menu dynamique a un sous-menu s’affiche. |
| DynamicHorizontalOffset |
Obtient ou définit le nombre de pixels à déplacer horizontalement d’un menu dynamique par rapport à son élément de menu parent. |
| DynamicHoverStyle |
Obtient une référence à l’objet Style qui vous permet de définir l’apparence d’un élément de menu dynamique lorsque le pointeur de la souris est positionné sur celui-ci. |
| DynamicItemFormatString |
Obtient ou définit du texte supplémentaire affiché avec tous les éléments de menu affichés dynamiquement. |
| DynamicItemTemplate |
Obtient ou définit le modèle qui contient le contenu personnalisé à afficher pour un menu dynamique. |
| DynamicMenuItemStyle |
Obtient une référence à l’objet MenuItemStyle qui vous permet de définir l’apparence des éléments de menu dans un menu dynamique. |
| DynamicMenuStyle |
Obtient une référence à l’objet MenuItemStyle qui vous permet de définir l’apparence d’un menu dynamique. |
| DynamicPopOutImageTextFormatString |
Obtient ou définit le texte de remplacement de l’image utilisée pour indiquer qu’un élément de menu dynamique a un sous-menu. |
| DynamicPopOutImageUrl |
Obtient ou définit l’URL d’une image personnalisée qui s’affiche dans un élément de menu dynamique lorsque l’élément de menu dynamique a un sous-menu. |
| DynamicSelectedStyle |
Obtient une référence à l’objet MenuItemStyle qui vous permet de définir l’apparence de l’élément de menu dynamique sélectionné par l’utilisateur. |
| DynamicTopSeparatorImageUrl |
Obtient ou définit l’URL d’une image à afficher en haut de chaque élément de menu dynamique pour le séparer des autres éléments de menu. |
| DynamicVerticalOffset |
Obtient ou définit le nombre de pixels à déplacer verticalement un menu dynamique par rapport à son élément de menu parent. |
| 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) |
| 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) |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| 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) |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| 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) |
| IncludeStyleBlock |
Obtient ou définit une valeur qui indique si ASP.NET doit afficher un bloc de définitions de feuille de style en cascade (CSS) pour les styles utilisés dans le menu. |
| Initialized |
Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Obtient une valeur indiquant si la DataSourceID propriété est définie. (Hérité de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsDataBindingAutomatic |
Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl) |
| 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) |
| IsUsingModelBinders |
En cas d’implémentation dans une classe dérivée, obtient une valeur qui indique si le contrôle utilise des classeurs de modèles. (Hérité de BaseDataBoundControl) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control) |
| Items |
Obtient un MenuItemCollection objet qui contient tous les éléments de menu dans le Menu contrôle. |
| ItemWrap |
Obtient ou définit une valeur indiquant si le texte des éléments de menu doit être encapsulé. |
| LevelMenuItemStyles |
Obtient un MenuItemStyleCollection objet qui contient les paramètres de style appliqués aux éléments de menu en fonction de leur niveau dans un Menu contrôle. |
| LevelSelectedStyles |
Obtient un MenuItemStyleCollection objet qui contient les paramètres de style appliqués à l’élément de menu sélectionné en fonction de son niveau dans un Menu contrôle. |
| LevelSubMenuStyles |
Obtient un MenuItemStyleCollection objet qui contient les paramètres de style appliqués aux sous-éléments du menu statique en fonction de leur niveau dans un Menu contrôle. |
| 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) |
| MaximumDynamicDisplayLevels |
Obtient ou définit le nombre de niveaux de menu à afficher pour un menu dynamique. |
| 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) |
| Orientation |
Obtient ou définit la direction dans laquelle afficher le Menu contrôle. |
| 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) |
| PathSeparator |
Obtient ou définit le caractère utilisé pour délimiter le chemin d’un élément de menu dans un Menu contrôle. |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RenderingMode |
Obtient ou définit une valeur qui spécifie si le Menu contrôle affiche des éléments HTML |
| RequiresDataBinding |
Obtient ou définit une valeur indiquant si la DataBind() méthode doit être appelée. (Hérité de BaseDataBoundControl) |
| ScrollDownImageUrl |
Obtient ou définit l’URL d’une image affichée dans un menu dynamique pour indiquer que l’utilisateur peut faire défiler vers le bas pour des éléments de menu supplémentaires. |
| ScrollDownText |
Obtient ou définit le texte de remplacement de l’image spécifiée dans la ScrollDownImageUrl propriété. |
| ScrollUpImageUrl |
Obtient ou définit l’URL d’une image affichée dans un menu dynamique pour indiquer que l’utilisateur peut faire défiler vers le haut pour des éléments de menu supplémentaires. |
| ScrollUpText |
Obtient ou définit le texte de remplacement de l’image spécifiée dans la ScrollUpImageUrl propriété. |
| SelectedItem |
Obtient l’élément de menu sélectionné. |
| SelectedValue |
Obtient la valeur de l’élément de menu sélectionné. |
| 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) |
| SkipLinkText |
Obtient ou définit le texte de remplacement d’une image masquée lue par les lecteurs d’écran pour permettre d’ignorer la liste des liens. |
| StaticBottomSeparatorImageUrl |
Obtient ou définit l’URL d’une image affichée en tant que séparateur en bas de chaque élément de menu statique. |
| StaticDisplayLevels |
Obtient ou définit le nombre de niveaux de menu à afficher dans un menu statique. |
| StaticEnableDefaultPopOutImage |
Obtient ou définit une valeur indiquant si l’image intégrée est affichée pour indiquer qu’un élément de menu statique a un sous-menu. |
| StaticHoverStyle |
Obtient une référence à l’objet Style qui vous permet de définir l’apparence d’un élément de menu statique lorsque le pointeur de la souris est positionné sur celui-ci. |
| StaticItemFormatString |
Obtient ou définit du texte supplémentaire affiché avec tous les éléments de menu affichés statiquement. |
| StaticItemTemplate |
Obtient ou définit le modèle qui contient le contenu personnalisé à afficher pour un menu statique. |
| StaticMenuItemStyle |
Obtient une référence à l’objet MenuItemStyle qui vous permet de définir l’apparence des éléments de menu dans un menu statique. |
| StaticMenuStyle |
Obtient une référence à l’objet MenuItemStyle qui vous permet de définir l’apparence d’un menu statique. |
| StaticPopOutImageTextFormatString |
Obtient ou définit le texte de remplacement de l’image contextuelle utilisée pour indiquer qu’un élément de menu statique a un sous-menu. |
| StaticPopOutImageUrl |
Obtient ou définit l’URL d’une image affichée pour indiquer qu’un élément de menu statique a un sous-menu. |
| StaticSelectedStyle |
Obtient une référence à l’objet MenuItemStyle qui vous permet de définir l’apparence de l’élément de menu sélectionné par l’utilisateur dans un menu statique. |
| StaticSubMenuIndent |
Obtient ou définit la quantité d’espace, en pixels, pour mettre en retrait les sous-menus dans un menu statique. |
| StaticTopSeparatorImageUrl |
Obtient ou définit l’URL d’une image affichée en tant que séparateur en haut de chaque élément de menu statique. |
| 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 à un Menu contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. |
| 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) |
| Target |
Obtient ou définit la fenêtre ou le cadre cible dans lequel afficher le contenu de la page Web associé à un élément de menu. |
| 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) |
| 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) |
| 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) |
| 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 html et des styles qui doivent être rendus à l’objet spécifié HtmlTextWriter . |
| 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) |
| ConfirmInitState() |
Définit l’état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl) |
| 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 les contrôles enfants d’un Menu contrôle. |
| CreateControlCollection() |
Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée l’objet de style utilisé en interne par la WebControl classe pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| DataBind() |
Lie la source de données au Menu contrôle. Cette méthode ne peut pas être héritée. |
| 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 de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| 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) |
| EnsureDataBound() |
Vérifie que le contrôle de menu nécessite une liaison de données et qu’un contrôle de source de données valide est spécifié avant d’appeler la DataBind() méthode. |
| 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é |
| FindItem(String) |
Récupère l’élément de menu au chemin de valeur spécifié. |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetData(String) |
Récupère un HierarchicalDataSourceView objet que le contrôle lié aux données utilise pour effectuer des opérations de données. (Hérité de HierarchicalDataBoundControl) |
| GetDataSource() |
Récupère le IHierarchicalDataSource contrôle lié aux données associé, le cas échéant. (Hérité de HierarchicalDataBoundControl) |
| GetDesignModeState() |
Récupère l’état au moment du design du Menu contrôle. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| 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) |
Charge l’état des propriétés dans le Menu contrôle qui doivent être conservées. |
| LoadViewState(Object) |
Charge l’état d’affichage précédemment enregistré du Menu contrôle. |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MarkAsDataBound() |
Définit l’état du contrôle dans l’état d’affichage comme étant lié avec succès aux données. (Hérité de HierarchicalDataBoundControl) |
| 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) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement du Menu contrôle est transmis à la hiérarchie de contrôle serveur de l’interface utilisateur de la page. |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. |
| OnDataBound(EventArgs) |
Déclenche l’événement DataBound. (Hérité de BaseDataBoundControl) |
| OnDataPropertyChanged() |
Appelée lorsqu’une des propriétés d’identification de la source de données de base est modifiée, pour lier à nouveau le contrôle lié aux données à ses données. (Hérité de HierarchicalDataBoundControl) |
| OnDataSourceChanged(Object, EventArgs) |
Appelé lorsque l’instance IHierarchicalDataSource avec laquelle le contrôle lié aux données fonctionne avec déclenche l’événement DataSourceChanged . (Hérité de HierarchicalDataBoundControl) |
| OnInit(EventArgs) |
Déclenche l’événement Init. |
| OnLoad(EventArgs) |
Gère l’événement Load . (Hérité de HierarchicalDataBoundControl) |
| OnMenuItemClick(MenuEventArgs) |
Déclenche l’événement MenuItemClick. |
| OnMenuItemDataBound(MenuEventArgs) |
Déclenche l’événement MenuItemDataBound. |
| OnPagePreLoad(Object, EventArgs) |
Définit l’état initialisé du contrôle lié aux données avant le chargement du contrôle. (Hérité de HierarchicalDataBoundControl) |
| 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) |
| PerformDataBinding() |
Lie les éléments de la source de données aux éléments de menu du Menu contrôle. |
| PerformSelect() |
Récupère les données de la source de données associée. (Hérité de HierarchicalDataBoundControl) |
| 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) |
Traite un événement déclenché lorsqu’un formulaire est publié sur le serveur. |
| 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) |
Affiche le contrôle de menu dans le navigateur client. |
| RenderBeginTag(HtmlTextWriter) |
Ajoute des attributs de balise et écrit le balisage de la balise d’ouverture du contrôle dans le flux de sortie émis dans le navigateur ou l’appareil. |
| 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) |
Ce membre remplace RenderContents(HtmlTextWriter). |
| 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) |
| RenderEndTag(HtmlTextWriter) |
Effectue le balisage final et écrit la balise de fermeture HTML du contrôle dans le flux de sortie émis dans le navigateur ou l’appareil. |
| 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) |
| SaveControlState() |
Enregistre l’état des propriétés dans le Menu contrôle qui doivent être conservées. |
| SaveViewState() |
Enregistre l’état du Menu contrôle. |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour le Menu contrôle. |
| SetItemDataBound(MenuItem, Boolean) |
Définit la DataBound propriété de l’objet spécifié MenuItem avec la valeur spécifiée. |
| SetItemDataItem(MenuItem, Object) |
Définit la DataItem propriété de l’objet spécifié MenuItem avec la valeur spécifiée. |
| SetItemDataPath(MenuItem, String) |
Définit la DataPath propriété de l’objet spécifié MenuItem avec la valeur spécifiée. |
| 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() |
Effectue le suivi des modifications de l’état d’affichage du Menu contrôle afin qu’elles puissent être stockées dans l’objet du StateBag contrôle. Cet objet est accessible via la ViewState propriété. |
| ValidateDataSource(Object) |
Vérifie que l’objet auquel un contrôle lié aux données est lié est un contrôle qu’il peut utiliser. (Hérité de HierarchicalDataBoundControl) |
Événements
| Nom | Description |
|---|---|
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| DataBound |
Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl) |
| 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) |
| MenuItemClick |
Se produit lorsqu’un élément de menu dans un Menu contrôle est cliqué. |
| MenuItemDataBound |
Se produit lorsqu’un élément de menu d’un Menu contrôle est lié aux données. |
| 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) |
| 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) |
Traite un événement déclenché lorsqu’un formulaire est publié sur le serveur. |
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é. |
| EnablePersistedSelection(BaseDataBoundControl) |
Obsolète.
Permet de conserver la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination. |
| 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. |
