SiteMap.CurrentNode Propriété

Définition

Obtient un contrôle SiteMapNode qui représente la page actuellement demandée.

public:
 static property System::Web::SiteMapNode ^ CurrentNode { System::Web::SiteMapNode ^ get(); };
public static System.Web.SiteMapNode CurrentNode { get; }
static member CurrentNode : System.Web.SiteMapNode
Public Shared ReadOnly Property CurrentNode As SiteMapNode

Valeur de propriété

Instance de SiteMapNode qui représente la page actuellement demandée ; sinon, null, si aucun nœud représentatif n'existe dans les informations de plan de site.

Exceptions

La fonction de plan de site n'est pas activée.

Le fournisseur par défaut spécifié dans la configuration est introuvable.

La fonctionnalité est prise en charge uniquement lors de l'exécution en mode Confiance basse ou dans un mode supérieur.

Exemples

L’exemple de code suivant montre comment utiliser la CurrentNode propriété pour récupérer l’objet SiteMapNode qui représente la page active.

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    // Examine the CurrentNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.CurrentNode.Title + "<br />");
    Response.Write("<font COLOR='red'>" + SiteMap.CurrentNode.Url + "</font><br />");

    // What nodes are children of the CurrentNode?
    if (SiteMap.CurrentNode.HasChildNodes) {
        IEnumerator childNodesEnumerator = SiteMap.CurrentNode.ChildNodes.GetEnumerator();
        while (childNodesEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(childNodesEnumerator.Current.ToString() + "<br />");
        }
    }
    Response.Write("<hr />");

    // Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title + "<br />");
    Response.Write(SiteMap.RootNode.Url + "<br />");

    // What nodes are children of the RootNode?
    if (SiteMap.RootNode.HasChildNodes) {
        IEnumerator rootNodesChildrenEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator();
        while (rootNodesChildrenEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(rootNodesChildrenEnumerator.Current.ToString() + "<br />");
        }
    }
}
</script>
<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Examine the CurrentNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.CurrentNode.Title & "<br />")
    Response.Write("<font COLOR='red'>" & SiteMap.CurrentNode.Url & "</font><br />")

    ' What nodes are children of the CurrentNode?
    If (SiteMap.CurrentNode.HasChildNodes) Then
        Dim ChildNodesEnumerator As IEnumerator = SiteMap.CurrentNode.ChildNodes.GetEnumerator()
        While (ChildNodesEnumerator.MoveNext())
            ' Prints the Title of each node.
            Response.Write(ChildNodesEnumerator.Current.ToString() & "<br />")
        End While
    End If
    Response.Write("<hr />")

    ' Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title & "<br />")
    Response.Write(SiteMap.RootNode.Url & "<br />")

    ' What nodes are children of the RootNode?
    If (SiteMap.RootNode.HasChildNodes) Then
        Dim RootNodesChildrenEnumerator As IEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator()
        While (RootNodesChildrenEnumerator.MoveNext())
            ' Prints the Title of each node.
            Response.Write(RootNodesChildrenEnumerator.Current.ToString() & "<br />")
        End While
    End If

End Sub ' Page_Load
</script>

Remarques

La SiteMap classe récupère la propriété en la CurrentNode demandant au fournisseur.

Si aucun nœud représentatif n’existe pour la page dans les informations de plan de site, ou si le découpage de sécurité est activé et que le nœud ne peut pas être retourné pour l’utilisateur actuel, null est retourné.

L’événement SiteMapResolve est déclenché par le fournisseur de plan de site par défaut si un ou plusieurs abonnements existent.

Si vous implémentez votre propre SiteMapProvider objet, vous pouvez créer votre propre mécanisme pour rechercher et récupérer le CurrentNode. Toutefois, si vous étendez la StaticSiteMapProvider classe et utilisez un schéma basé sur une URL pour identifier les pages, vous pouvez remplacer la FindSiteMapNode méthode .

S’applique à

Voir aussi