Partilhar via


SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Método

Definição

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 -> unit
Public 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.

Aplica-se a

Confira também