Cette documentation est archivée et n’est pas conservée.

Menu.PathSeparator, propriété

Mise à jour : novembre 2007

Obtient ou définit le caractère utilisé pour délimiter le chemin d'un élément de menu dans un contrôle Menu.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

public char PathSeparator { get; set; }
/** @property */
public char get_PathSeparator()
/** @property */
public  void set_PathSeparator(char value)

public function get PathSeparator () : char
public function set PathSeparator (value : char)
<asp:Menu PathSeparator="Char" />

Valeur de propriété

Type : System.Char

Caractère utilisé pour délimiter le chemin d'un élément de menu. La valeur par défaut est une barre oblique (/).

Chaque élément de menu (représenté par un objet MenuItem) du contrôle Menu a une propriété ValuePath qui spécifie la position de l'élément de menu. Le chemin de valeur est une chaîne de valeurs délimitées qui forment le chemin allant d'un élément de menu racine à l'élément de menu actuel. Utilisez la propriété PathSeparator pour spécifier le caractère de délimitation utilisé pour séparer les valeurs dans le chemin d'accès de menu. Cette valeur est couramment utilisée lors de l'analyse de la liste des valeurs.

En fonction du texte affiché dans le contrôle Menu, le caractère du séparateur devra éventuellement être modifié pour éviter des conflits. Par exemple, si vous choisissez la virgule comme séparateur, le texte affiché ne doit pas contenir de virgules ; sinon, la propriété ValuePath ne peut pas être analysée correctement.

L'exemple de code suivant montre comment utiliser la propriété PathSeparator pour remplacer le caractère de séparateur d'un chemin d'accès de valeur d'un élément de menu par une virgule.


<%@ 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 Page_Load(Object sender, EventArgs e)
  {
    // The value path for a menu item is a delimited list
    // of menu text values that form a path from the root 
    // menu item to the current menu item.

    // Declare the value path to the Classical menu item using
    // the delimiter character specified in the PathSeparator
    // property. In this example, the delimiter character is a
    // comma.
    String valuePath = "Home,Music,Classical";

    // Use the FindItem method to get the Classical menu item using
    // its value path.
    MenuItem item = NavigationMenu.FindItem(valuePath);

    // Indicate whether the menu item was found.
    if (item != null)
    {
      Message.Text = item.Text + " menu item found at depth " + 
        item.Depth.ToString() + ".";
    }
    else
    {
      Message.Text = "Menu item not found.";
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Menu PathSeparator and FindItem Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Menu PathSeparator and FindItem Example</h3>

      <!-- Use the PathSeparator property to  -->
      <!-- change the delimiter character for -->
      <!-- the value path of a menu item to a -->
      <!-- comma (,).                         -->
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        pathseparator="," 
        runat="server">

        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

      </asp:menu>

      <hr/>

      <asp:label id="Message" 
        runat="server"/>

    </form>
  </body>
</html>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: