Partilhar via


SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Método

Definição

Fornece um método que os provedores de mapa de site podem substituir para executar uma recuperação de nós otimizada localizada na proximidade do nó especificado.

public:
 virtual void HintNeighborhoodNodes(System::Web::SiteMapNode ^ node, int upLevel, int downLevel);
public virtual void HintNeighborhoodNodes (System.Web.SiteMapNode node, int upLevel, int downLevel);
abstract member HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
override this.HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
Public Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel As Integer)

Parâmetros

node
SiteMapNode

O SiteMapNode que funciona como um ponto de referência para upLevel.

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 (e seus nós descendentes para o nível do node) podem ser recuperados e armazenados em cache.

downLevel
Int32

O número de gerações SiteMapNode descendentes a serem buscadas. 0 indica que nenhum nó descendente é recuperado e -1 indica que todos os nós descendentes podem ser recuperados e armazenados em cache.

Exceções

upLevel ou downLevel é menor que -1.

node é null.

Comentários

O método padrão HintNeighborhoodNodes verifica apenas um upLevel e downLevel parâmetros menores que -1 e um node parâmetro que é null. Como o XmlSiteMapProvider objeto armazena em cache informações do mapa do site na memória, o HintNeighborhoodNodes método não é usado.

Os provedores de mapa de site podem substituir o HintNeighborhoodNodes método para executar uma pesquisa otimizada dos SiteMapNode objetos nas proximidades dos especificados SiteMapNode. O upLevel parâmetro é usado para especificar quantos níveis de nós pai e ancestral devem ser percorridos do especificado SiteMapNode. O downLevel parâmetro é usado para especificar quantos níveis de nós filho do nó atual recuperar. Se preferir, os nós ancestrais e descendentes podem ser vinculados ao SiteMapNode que é retornado pelo HintNeighborhoodNodes método, usando o e ChildNodes as ParentNode propriedades.

Aplica-se a

Confira também