MenuItem.Value Propriété
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.
Obtient ou définit une valeur non affichée utilisée pour stocker des données supplémentaires relatives à l'élément de menu, par exemple les données utilisées pour la gestion des événements de publication (postback).
public:
property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };public string Value { get; set; }member this.Value : string with get, setPublic Property Value As StringValeur de propriété
Données supplémentaires relatives à l'élément de menu qui n'est pas affiché. La valeur par défaut est une chaîne vide ("").
Exemples
L’exemple suivant montre comment afficher pour un élément de Value menu et son parent lorsque l’utilisateur sélectionne un élément de menu.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void NavigationMenu_MenuItemClick(Object sender, MenuEventArgs e)
{
// Display the selected menu item.
if (e.Item.Parent != null)
{
Message.Text = "You selected " + e.Item.Value +
" from " + e.Item.Parent.Value + ".";
}
else
{
Message.Text = "You selected " + e.Item.Value + ".";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem Value Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Value Example</h3>
Select an item from the menu:<br/><br/>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
onmenuitemclick="NavigationMenu_MenuItemClick"
runat="server">
<dynamicselectedstyle backcolor="yellow"/>
<staticselectedstyle backcolor="yellow"/>
<items>
<asp:menuitem text="Home"
tooltip="Home">
<asp:menuitem text="Category"
value="Category 1"
tooltip="Category 1">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
<asp:menuitem text="Category"
value="Category 2"
tooltip="Category 2">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
<hr/>
<asp:label id="Message"
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">
<script runat="server">
Sub NavigationMenu_MenuItemClick(ByVal sender As Object, ByVal e As MenuEventArgs)
' Display the selected menu item.
If e.Item.Parent IsNot Nothing Then
Message.Text = "You selected " & e.Item.Value & _
" from " & e.Item.Parent.Value & "."
Else
Message.Text = "You selected " & e.Item.Value & "."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem Value Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Value Example</h3>
Select an item from the menu:<br/><br/>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
onmenuitemclick="NavigationMenu_MenuItemClick"
runat="server">
<dynamicselectedstyle backcolor="yellow"/>
<staticselectedstyle backcolor="yellow"/>
<items>
<asp:menuitem text="Home"
tooltip="Home">
<asp:menuitem text="Category"
value="Category 1"
tooltip="Category 1">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
<asp:menuitem text="Category"
value="Category 2"
tooltip="Category 2">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
Remarques
La Value propriété est utilisée pour compléter la Text propriété en stockant toutes les données supplémentaires associées à l’élément de menu. Cette valeur n’est pas affichée dans le contrôle et est couramment utilisée pour stocker des données pour la gestion des événements de publication.
Notes
Si la Value propriété contient null, l’accesseur get retourne la valeur de la Text propriété . Si la Text propriété, à son tour, contient null, Empty est retournée.
La valeur de la Value propriété est également utilisée lorsque le chemin d’accès à la valeur spécifié dans la ValuePath propriété est généré. Un chemin de valeur est une liste séparée par un délimiteur de valeurs d’élément de menu qui forme un chemin d’accès de l’élément de menu racine à l’élément de menu actif. Le chemin de la valeur est utilisé pour indiquer la position d’un élément de menu dans un Menu contrôle.
Notes
Les éléments de menu au même niveau de menu doivent avoir chacun une valeur unique pour la Value propriété ; le Menu contrôle ne peut pas faire la distinction entre différents éléments de menu au même niveau qui ont la même valeur.
La valeur de cette propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de concepteur. Pour plus d’informations, consultez LocalizableAttributeglobalisation et localisation.
