Compartilhar via


SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Método

Definição

Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar o nó para a página solicitada no momento e ao buscar os nós de mapa de site pai e ancestral para a página atual.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);
abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

Parâmetros

upLevel
Int32

O número de gerações do nó de mapa de site ancestral a ser obtido. Um valor de -1 indica que todos os ancestrais podem ser recuperados e armazenados em cache pelo provedor.

Retornos

SiteMapNode

Um SiteMapNode que representa a página atualmente solicitada; caso contrário, null, se o SiteMapNode não for encontrado ou não puder ser retornado para o usuário atual.

Exceções

upLevel é menor que -1.

Comentários

A implementação padrão do GetCurrentNodeAndHintAncestorNodes método retorna a CurrentNode propriedade; no entanto, os provedores de mapa de site podem substituir o GetCurrentNodeAndHintAncestorNodes método e fornecer uma implementação otimizada que usa mecanismos de cache personalizados para retornar o atual SiteMapNode, bem como os nós pai e ancestral do pai.

O upLevel parâmetro é usado para especificar quantos níveis de nós pai e ancestral recuperar. Se preferir, os nós pai e ancestral podem ser vinculados ao SiteMapNode objeto retornado pelo GetCurrentNodeAndHintAncestorNodes método, usando a ParentNode propriedade.

A XmlSiteMapProvider classe, que é o provedor de mapa de site padrão para ASP.NET, armazena em cache todo o mapa do site na memória, o que resulta em pouca ou nenhuma sobrecarga ao consultar objetos XmlSiteMapProvider específicosSiteMapNode.

Aplica-se a

Confira também