SiteMap.CurrentNode Proprietà

Definizione

Ottiene un controllo SiteMapNode che rappresenta la pagina attualmente richiesta.Gets a SiteMapNode control that represents the currently requested page.

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

Valore della proprietà

Istanza SiteMapNode che rappresenta la pagina attualmente richiesta; in caso contrario, null se non esiste alcun nodo rappresentativo nelle informazioni relative alla mappa del sito.A SiteMapNode instance that represents the currently requested page; otherwise, null, if no representative node exists in the site map information.

Eccezioni

La funzionalità relativa alla mappa del sito non è attivata.The site map feature is not enabled.

Il provider predefinito specificato nella configurazione non esiste.The default provider specified in the configuration does not exist.

La funzionalità è supportata solo quando in esecuzione in modalità di attendibilità bassa o in una modalità di livello superiore.The feature is supported only when running in Low trust or higher.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato CurrentNode come utilizzare la proprietà SiteMapNode per recuperare l'oggetto che rappresenta la pagina corrente.The following code example demonstrates how to use the CurrentNode property to retrieve the SiteMapNode object that represents the current page.

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

Commenti

La SiteMap classe recupera la CurrentNode proprietà richiedendo il provider.The SiteMap class retrieves the CurrentNode property by requesting it from the provider.

Se non esiste alcun nodo rappresentativo per la pagina nelle informazioni della mappa del sito o se è attivata la rimozione di sicurezza e il nodo non può essere restituito null per l'utente corrente, viene restituito.If no representative node exists for the page in the site map information, or if security trimming is enabled and the node cannot be returned for the current user, null is returned.

L' SiteMapResolve evento viene generato dal provider della mappa del sito predefinito se sono presenti una o più sottoscrizioni.The SiteMapResolve event is raised by the default site map provider if one or more subscriptions exist.

Se si implementa un oggetto SiteMapProvider personalizzato, è possibile creare un meccanismo personalizzato per individuare e CurrentNoderecuperare.If you implement your own SiteMapProvider object, you might create your own mechanism to find and retrieve the CurrentNode. Tuttavia, se si estende la StaticSiteMapProvider classe e si usa uno schema basato su URL per identificare le pagine, è possibile FindSiteMapNode eseguire l'override del metodo.However, if you extend the StaticSiteMapProvider class and use a URL-based scheme to identify pages, you can override the FindSiteMapNode method.

Si applica a

Vedi anche