SiteMap.CurrentNode 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 un SiteMapNode contrôle 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.SiteMapNodePublic Shared ReadOnly Property CurrentNode As SiteMapNodeValeur de propriété
Instance SiteMapNode qui représente la page actuellement demandée ; sinon, nullsi aucun nœud représentatif n’existe dans les informations de carte de site.
Exceptions
La fonctionnalité de carte de site n’est pas activée.
Le fournisseur par défaut spécifié dans la configuration n’existe pas.
La fonctionnalité est prise en charge uniquement lors de l’exécution en faible confiance ou ultérieure.
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 CurrentNode propriété en la demandant auprès du fournisseur.
Si aucun nœud représentatif n’existe pour la page dans les informations de carte 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 il est retourné.
L’événement SiteMapResolve est déclenché par le fournisseur de carte 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 l’URL pour identifier les pages, vous pouvez remplacer la FindSiteMapNode méthode.
