SiteMap.CurrentNode Propriedade

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Recebe um SiteMapNode controlo que representa a página atualmente 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 Propriedade

SiteMapNode

Uma SiteMapNode instância que representa a página atualmente solicitada; caso contrário, null, se não existir um nó representativo na informação do mapa do site.

Exceções

InvalidOperationException

A funcionalidade de mapa do local não está ativada.

ConfigurationErrorsException

O fornecedor padrão especificado na configuração não existe.

HttpException

A funcionalidade é suportada apenas quando está a correr em Baixa Confiança ou superior.

Exemplos

O exemplo de código seguinte demonstra como usar a CurrentNode propriedade para recuperar o SiteMapNode objeto que representa a página atual.

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

Observações

A SiteMap classe recupera a CurrentNode propriedade solicitando-a ao fornecedor.

Se não existir um nó representativo para a página na informação do mapa do site, ou se o ajuste de segurança estiver ativado e o nó não puder ser devolvido ao utilizador atual, null é devolvido.

O SiteMapResolve evento é levantado pelo fornecedor de mapas do site por defeito se existirem uma ou mais subscrições.

Se implementares o teu próprio SiteMapProvider objeto, podes criar o teu próprio mecanismo para encontrar e recuperar o CurrentNode. No entanto, se estender a StaticSiteMapProvider classe e usar um esquema baseado em URL para identificar páginas, pode sobrepor o FindSiteMapNode método.

Aplica-se a

Ver também