SiteMapNodeItemType Enum

Definition

L'énumération SiteMapNodeItemType est utilisée par le contrôle SiteMapPath pour identifier le type d'un nœud SiteMapNodeItem dans une hiérarchie de nœuds.The SiteMapNodeItemType enumeration is used by the SiteMapPath control to identify the type of a SiteMapNodeItem node within a node hierarchy.

public enum class SiteMapNodeItemType
public enum SiteMapNodeItemType
type SiteMapNodeItemType = 
Public Enum SiteMapNodeItemType
Inheritance
SiteMapNodeItemType

Fields

Current 2

Page actuellement affichée dans le chemin de navigation de site.The currently viewed page in the site navigation path.

Parent 1

Nœud parent de la page actuellement affichée dans le chemin de navigation de site.A parent node of the currently viewed page in the site navigation path. Un nœud parent correspond à tout nœud situé entre le nœud racine et le nœud actuel dans la hiérarchie de navigation.A parent node is any node that is found between the root node and the current node in the navigation hierarchy.

PathSeparator 3

Séparateur de chemin pour la navigation de plan de site.A site map navigation path separator. Le séparateur par défaut pour le contrôle SiteMapPath est le caractère « > ».The default separator for the SiteMapPath control is the ">" character.

Root 0

Nœud supérieur dans la hiérarchie de navigation de site.The top node of the site navigation hierarchy. Il ne peut y avoir qu'un seul nœud racine.There can be only one root node.

Examples

L’exemple suivant montre comment appeler la méthode SiteMapPath.OnItemCreated après la création d’un SiteMapNodeItem dans la méthode SiteMapPath.InitializeItem.The following example demonstrates how to call the SiteMapPath.OnItemCreated method after creating a SiteMapNodeItem within the SiteMapPath.InitializeItem method. Cet exemple fait partie d’un exemple plus complet fourni pour la classe SiteMapPath.This example is part of a larger example provided for the SiteMapPath class.

private void AddDropDownListAfterCurrentNode(SiteMapNodeItem item) {

    SiteMapNodeCollection childNodes = item.SiteMapNode.ChildNodes;

    // Only do this work if there are child nodes.
    if (childNodes != null) {

        // Add another PathSeparator after the CurrentNode.
        SiteMapNodeItem finalSeparator =
            new SiteMapNodeItem(item.ItemIndex,
                                SiteMapNodeItemType.PathSeparator);

        SiteMapNodeItemEventArgs eventArgs =
            new SiteMapNodeItemEventArgs(finalSeparator);

        InitializeItem(finalSeparator);
        // Call OnItemCreated every time a SiteMapNodeItem is
        // created and initialized.
        OnItemCreated(eventArgs);

        // The pathSeparator does not bind to any SiteMapNode, so
        // do not call DataBind on the SiteMapNodeItem.
        item.Controls.Add(finalSeparator);

        // Create a DropDownList and populate it with the children of the
        // CurrentNode. There are no styles or templates that are applied
        // to the DropDownList control. If OnSelectedIndexChanged is raised,
        // the event handler redirects to the page selected.
        // The CurrentNode has child nodes.
        DropDownList ddList = new DropDownList();
        ddList.AutoPostBack = true;

        ddList.SelectedIndexChanged += new EventHandler(this.DropDownNavPathEventHandler);

        // Add a ListItem to the DropDownList for every node in the
        // SiteMapNodes collection.
        foreach (SiteMapNode node in childNodes) {
            ddList.Items.Add(new ListItem(node.Title, node.Url));
        }

        item.Controls.Add(ddList);
    }
}
Private Sub AddDropDownListAfterCurrentNode(item As SiteMapNodeItem)

   Dim childNodes As SiteMapNodeCollection = item.SiteMapNode.ChildNodes

   ' Only do this work if there are child nodes.
   If Not (childNodes Is Nothing) Then

      ' Add another PathSeparator after the CurrentNode.
      Dim finalSeparator As New SiteMapNodeItem(item.ItemIndex, SiteMapNodeItemType.PathSeparator)

      Dim eventArgs As New SiteMapNodeItemEventArgs(finalSeparator)

      InitializeItem(finalSeparator)
      ' Call OnItemCreated every time a SiteMapNodeItem is
      ' created and initialized.
      OnItemCreated(eventArgs)

      ' The pathSeparator does not bind to any SiteMapNode, so
      ' do not call DataBind on the SiteMapNodeItem.
      item.Controls.Add(finalSeparator)

      ' Create a DropDownList and populate it with the children of the
      ' CurrentNode. There are no styles or templates that are applied
      ' to the DropDownList control. If OnSelectedIndexChanged is raised,
      ' the event handler redirects to the page selected.
      ' The CurrentNode has child nodes.
      Dim ddList As New DropDownList()
      ddList.AutoPostBack = True

      AddHandler ddList.SelectedIndexChanged, AddressOf Me.DropDownNavPathEventHandler

      ' Add a ListItem to the DropDownList for every node in the
      ' SiteMapNodes collection.
      Dim node As SiteMapNode
      For Each node In  childNodes
         ddList.Items.Add(New ListItem(node.Title, node.Url))
      Next node

      item.Controls.Add(ddList)
   End If
End Sub

Remarks

Le contrôle SiteMapPath gère ses informations de navigation de site sous la forme d’une collection d’objets SiteMapNodeItem.The SiteMapPath control manages its site navigation information as a collection of SiteMapNodeItem objects. les objets SiteMapNodeItem représentent des types fonctionnelment différents de nœuds de SiteMapNode.SiteMapNodeItem objects represent functionally different types of SiteMapNode nodes. En conséquence, elles sont gérées par le contrôle SiteMapPath.Accordingly, they are managed by the SiteMapPath control. La liste suivante décrit les types de nœuds disponibles :The following list describes the types of nodes available:

  • Un nœud qui représente la page actuellement affichée.One node that represent the currently viewed page.

  • Un nœud qui est le nœud supérieur de la hiérarchie de navigation du site.One node that is the top node of the site navigation hierarchy.

  • Zéro, un ou plusieurs nœuds entre le nœud supérieur et le nœud actuel (nœuds parents).Zero or more nodes between the top node and the current node (parent nodes).

  • Zéro, un ou plusieurs nœuds qui représentent des séparateurs de chemin de navigation de site.Zero or more nodes that represent site navigation path separators.

Chaque nœud est lié aux données d’un SiteMapNodesous-jacent, à l’exception des nœuds du type PathSeparator.Each node is data-bound to an underlying SiteMapNode, except nodes of the PathSeparator type.

Applies to

See also