SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece um método de pesquisa otimizado para fornecedores de mapas de sites ao recuperar o nó da página atualmente solicitada e ao obter os nós de mapa do sítio pai e antepassado 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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParâmetros
- upLevel
- Int32
O número de gerações de nós do mapa do sítio ancestral a obter. Um valor de -1 indica que todos os antepassados podem ser recuperados e armazenados em cache pelo fornecedor.
Devoluções
A SiteMapNode que representa a página atualmente solicitada; caso contrário, null, se não SiteMapNode for encontrado ou não puder ser devolvido ao utilizador atual.
Exceções
upLevel é inferior a -1.
Observações
A implementação padrão do GetCurrentNodeAndHintAncestorNodes método devolve a propriedade CurrentNode ; no entanto, os fornecedores de mapas de site podem sobrescrever o GetCurrentNodeAndHintAncestorNodes método e fornecer uma implementação otimizada que utiliza mecanismos de cache personalizados para devolver 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 pais e antepassados recuperar. Se preferido, os nós pai e antepassado podem ser ligados ao SiteMapNode objeto que é devolvido pelo GetCurrentNodeAndHintAncestorNodes método, usando a ParentNode propriedade.
A classe XmlSiteMapProvider, que é o fornecedor padrão de mapas de sites para ASP.NET, armazena em cache todo o mapa do site na memória, o que resulta em pouca ou nenhuma sobrecarga ao consultar o XmlSiteMapProvider para objetos específicos SiteMapNode.
