SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 otimizada de um ou mais níveis de nós pai e ancestrais, relativos ao objeto SiteMapNode especificado.
public:
virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel 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 podem ser recuperados e armazenados em cache.
Exceções
upLevel é menor que -1.
node é null.
Comentários
O método padrão HintAncestorNodes verifica apenas um upLevel parâmetro menor que -1 e um node parâmetro que é null. Como a XmlSiteMapProvider classe armazena em cache informações do mapa do site na memória, o HintAncestorNodes método não é usado.
Os provedores de mapa de site podem substituir o HintAncestorNodes método para executar uma recuperação otimizada de nós pai e ancestral do objeto especificado SiteMapNode .
O upLevel parâmetro é usado para especificar quantos níveis de nós pai e ancestral devem ser percorridos do especificado SiteMapNode. Se houver menos níveis do que os solicitados, todos os nós ancestrais disponíveis serão retornados dentro do limite especificado. Se preferir, o nó pai pode ser vinculado ao especificado SiteMapNode usando a ParentNode propriedade.