Accueil Library Formation Code Téléchargements Support Evénements Communautés Forums
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

MenuItem.Value, propriété

.NET Framework 4.5

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).

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public string Value { get; set; }

Valeur de propriété

Type : System.String
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 ("").

La propriété Value permet de compléter la propriété Text par le stockage des 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 les données relatives à la gestion des événements de publication.

RemarqueRemarque

Si la propriété Value contient null, l'accesseur get retourne la valeur de la propriété Text. Si la propriété Text, à son tour, contient null, Empty est retourné.

La valeur de la propriété Value est également utilisée lorsque le chemin de valeur spécifié dans la propriété ValuePath est généré. Un chemin de valeur est une liste, avec le délimiteur comme séparateur, de valeurs d'élément de menu qui forme un chemin de l'élément de menu racine à l'élément de menu actuel. Le chemin de valeur permet d'indiquer la position d'un élément de menu dans un contrôle Menu.

RemarqueRemarque

Les éléments de menu au même niveau de menu doivent avoir chacun une valeur unique pour la propriété Value ; le contrôle Menu ne peut pas faire la distinction entre les différents éléments de menu au même niveau ayant 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 en utilisant un outil de conception. Pour plus d'informations, consultez LocalizableAttribute et ASP.NET Globalization and Localization.

L'exemple suivant indique comment afficher la Value d'un élément de menu et de son parent lorsque l'utilisateur sélectionne un élément de menu.

C#
VB
Copier 


<%@ 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>

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Confidentialité
© 2013 Microsoft. Tous droits réservés.
|
Commentaires sur le site
© 2013 Microsoft. Tous droits réservés.