SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.