SiteMap.CurrentNode Propiedad

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Obtiene un control SiteMapNode que representa la página actualmente solicitada.

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

Valor de propiedad

SiteMapNode

Una instancia SiteMapNode que representa la página actualmente solicitada; de lo contrario, es null, si no existe ningún nodo representativo en la información del mapa del sitio.

Excepciones

InvalidOperationException

La característica de mapa del sitio no está habilitada.

ConfigurationErrorsException

El proveedor predeterminado especificado en la configuración no existe.

HttpException

Sólo se admite esta característica cuando se ejecuta, como mínimo, con un nivel de confianza bajo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la CurrentNode propiedad para recuperar el SiteMapNode objeto que representa la página actual.

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

Comentarios

La SiteMap clase recupera la CurrentNode propiedad solicitándolo desde el proveedor.

Si no existe ningún nodo representativo para la página en la información del mapa del sitio, o si el recorte de seguridad está habilitado y no se puede devolver el nodo para el usuario actual, null se devuelve.

El SiteMapResolve evento se genera mediante el proveedor de mapa de sitio predeterminado si existe una o varias suscripciones.

Si implementa su propio SiteMapProvider objeto, puede crear su propio mecanismo para buscar y recuperar .CurrentNode Sin embargo, si extiende la StaticSiteMapProvider clase y usa un esquema basado en direcciones URL para identificar páginas, puede invalidar el FindSiteMapNode método .

Consulte también

• CurrentNode
• SiteMapResolve