SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, 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 sítios ao recuperar o nó da página atualmente solicitada e obter os nós do mapa do sítio próximos do nó atual.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNodeParâmetros
- upLevel
- Int32
O número de gerações de antepassados SiteMapNode para ir buscar. 0 indica que nenhum nó ancestral é recuperado e -1 indica que todos os antepassados podem ser recuperados e armazenados em cache pelo fornecedor.
- downLevel
- Int32
O número de gerações de crianças SiteMapNode para ir buscar. 0 indica que não são recuperados nós descendentes e um -1 indica que todos os nós descendentes 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 ou downLevel é inferior a -1.
Observações
A implementação padrão do GetCurrentNodeAndHintNeighborhoodNodes método devolve a propriedade CurrentNode ; no entanto, os fornecedores de mapas de site podem sobrescrever o GetCurrentNodeAndHintNeighborhoodNodes método e fornecer uma implementação otimizada que utiliza mecanismos de cache personalizados para devolver o objeto atual SiteMapNode , bem como SiteMapNode objetos que estejam na proximidade do atual SiteMapNode.
O upLevel parâmetro é usado para especificar quantos níveis de nós progenitores e antepassados devem recuperar e armazenar em cache, juntamente com os seus filhos imediatos. O downLevel parâmetro é usado para especificar quantos níveis de nós descendentes da corrente SiteMapNode devem ser recuperados. Se preferido, os nós antepassado e descendente podem ser ligados ao SiteMapNode que é devolvido pelo
GetCurrentNodeAndHintNeighborhoodNodes método, usando as ParentNode propriedades e ChildNodes . Se existirem menos níveis de nó ancestral ou filho do que o especificado por upLevel ou downLevel, apenas os disponíveis são recuperados.
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.
