Partilhar via


SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, 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 na proximidade 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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Parâmetros

upLevel
Int32

O número das gerações do SiteMapNode ancestral a ser buscado. 0 indica que nenhum nó ancestral é recuperado e -1 indica que todos os ancestrais podem ser recuperados e armazenados em cache pelo provedor.

downLevel
Int32

O número de gerações SiteMapNode filho a serem buscadas. 0 indica que nenhum nó descendente é recuperado e um -1 indica que todos os nós descendentes 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 ou downLevel é menor que -1.

Comentários

A implementação padrão do GetCurrentNodeAndHintNeighborhoodNodes método retorna a CurrentNode propriedade; no entanto, os provedores de mapa de site podem substituir o GetCurrentNodeAndHintNeighborhoodNodes método e fornecer uma implementação otimizada que usa mecanismos de cache personalizados para retornar o objeto atual SiteMapNode , bem como SiteMapNode objetos que estão próximos do atual SiteMapNode.

O upLevel parâmetro é usado para especificar quantos níveis de nós pai e ancestral recuperar e armazenar em cache, juntamente com seus filhos imediatos. O downLevel parâmetro é usado para especificar quantos níveis de nós descendentes do atual SiteMapNode recuperar. Se preferir, os nós ancestrais e descendentes podem ser vinculados ao SiteMapNode que é retornado pelo

GetCurrentNodeAndHintNeighborhoodNodesmétodo, usando o e ChildNodes as ParentNode propriedades. Se houver menos níveis de nó ancestral ou filho do que os especificados por upLevel ou downLevel, somente aqueles que estão disponíveis serão recuperados.

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